バージョン

分割 (xamSyntaxEditor)

トピックの概要

目的

このトピックでは、 xamSyntaxEditor™ のドキュメント分割機能と、そのカスタマイズ方法を説明します。

前提条件

このトピックの本題に入る前に、以下のトピックをお読みください。

トピック 目的

このトピックでは、 xamSyntaxEditor の 機能をわかりやすく解説します。

このトピックでは、開発者とユーザー双方の視点から xamSyntaxEditor コントロールのテキスト編集機能をまとめました。

はじめに

分割の要旨

xamSyntaxEditor では、編集領域を分割できます (左右または上下方向)。この機能を有効にすると、編集したドキュメントの 2 つのパーツの見た目を比較して、その両方を変更することができます。ユーザーはどちらの分割方法を使用するかを構成できます (以下の表参照)。また、 xamSyntaxEditor の 編集領域の現在の分割ステータスを決定できるプロパティがあります。

以下のスクリーンショットは、 xamSyntaxEditor の 分割ハンドルです。

xamSyntaxEditor Splitting1.png

以下のスクリーンショットは、 xamSyntaxEditor を上下に分割した状態です。

xamSyntaxEditor Splitting2.png

コントロール構成の要旨

コントロール構成の要旨表

以下の表は、 xamSyntaxEditor の 分割機能で構成できる要素をまとめたものです。

構成可能な要素 詳細 プロパティ

ユーザーが利用できる分割方法を有効/無効にできます。

現在の分割ステータスを取得/設定でき、編集領域が分割されたか、そしてどのように分割されたかを確認できます。

注:

Note

分割タイプを有効/無効にするコマンドと分割を設定するコマンドも利用できます。詳細については、 イベントとコマンドのトピックを参照してください。

各種分割タイプの有効化/無効化

概要

ユーザーが利用できる分割方法を有効/無効にできます。

プロパティ設定

以下の表は、構成目的をプロパティ設定にマップした表です。

目的: 使用するプロパティ: 設定の選択肢:

ユーザーが利用できる分割オプションを変更

SplitOptions

以下のスクリーンショットは、以下の設定による、 xamSyntaxEditor の表示結果です。

プロパティ

SplitOptions

EditorDocumentViewSplitOptions.AllowVerticalSplitsOnly

xamSyntaxEditor Splitting3.png

現在の分割ステータスの取得/設定

概要

現在の分割ステータスを取得/設定でき、編集領域が分割されたか、そしてどのように分割されたかを確認できます。

プロパティ設定

以下の表は、構成目的をプロパティ設定にマップした表です。

目的: 使用するプロパティ: 対応または選択肢

現在の分割ステータスを取得

SplitStatus

値を読み取る

現在の分割ステータスを設定

SplitStatus

タイプ EditorDocumentViewSplitStatus の値に設定する

コード

以下のコード例では、現在の分割ステータスの取得方法を示します。

C# の場合:

if (this.xamSyntaxEditor1.SplitStatus ==
    EditorDocumentViewSplitStatus.SplitHorizontally)
{
    // 何かの操作を行う
}
else if (this.xamSyntaxEditor1.SplitStatus ==
    EditorDocumentViewSplitStatus.SplitVertically)
{
    // さらに他の何かの操作を行う
}

Visual Basic の場合:

If Me.xamSyntaxEditor1.SplitStatus = _
    EditorDocumentViewSplitStatus.SplitHorizontally Then
        ' 何かの操作を行う
ElseIf Me.xamSyntaxEditor1.SplitStatus = _
    EditorDocumentViewSplitStatus.SplitVertically Then
        ' さらに他の何かの操作を行う
End If

以下のコード例では、現在の分割ステータスを左右に設定する方法を示します。

C# の場合:

this.xamSyntaxEditor1.SplitStatus = EditorDocumentViewSplitStatus.SplitVertically;

Visual Basic の場合:

Me.xamSyntaxEditor1.SplitStatus = EditorDocumentViewSplitStatus.SplitVertically

関連コンテンツ

このトピックについては、以下のトピックも参照してください。

トピック 目的

このトピックでは、 xamSyntaxEditor 内のドキュメントのコンテンツの表示の変更方法を説明します。

このトピックは現在の行の強調表示機能について説明します。