ITextRow インターフェイス (tom.h)

ITextRow インターフェイスには、1 つ以上の同じテーブル行を挿入し、テーブル行のプロパティを取得および変更するためのメソッドが用意されています。 一意でない行を挿入するには、行構成ごとに ITextRow::Insert を呼び出します。

継承

ITextRow インターフェイスは、IDispatch インターフェイスから継承されます。 ITextRow には、次の種類のメンバーもあります。

メソッド

ITextRow インターフェイスには、これらのメソッドがあります。

ITextRow::Apply このテキスト行オブジェクトの書式設定属性を、関連付けられている ITextRange2 内の指定された行に適用します。
ITextRow::CanChange この行に変更を加えることができるかどうかを決定します。
ITextRow::GetAlignment 行の水平方向の配置を取得します。
ITextRow::GetCellAlignment アクティブ セルの垂直方向の配置を取得します。
ITextRow::GetCellBorderColors アクティブ セルの罫線の色を取得します。
ITextRow::GetCellBorderWidths アクティブ セルの罫線の幅を取得します。
ITextRow::GetCellColorBack アクティブ セルの背景色を取得します。
ITextRow::GetCellColorFore アクティブ セルの前景色を取得します。
ITextRow::GetCellCount この行のセルの数を取得します。
ITextRow::GetCellCountCache この行にキャッシュされたセルの数を取得します。
ITextRow::GetCellIndex パラメーターを取得または設定するアクティブ セルのインデックスを取得します。
ITextRow::GetCellMargin この行のセルの余白を取得します。
ITextRow::GetCellMergeFlags アクティブ セルのマージ フラグを取得します。
ITextRow::GetCellShading アクティブ セルの網かけを取得します。
ITextRow::GetCellVerticalText アクティブ セルの縦書きテキストの設定を取得します。
ITextRow::GetCellWidth アクティブ セルの幅を取得します。
ITextRow::GetHeight 行の高さを取得します。
ITextRow::GetIndent この行のインデントを取得します。
ITextRow::GetKeepTogether この行をページ間で分割できるかどうかを取得します。
ITextRow::GetKeepWithNext この行が、その後の行と同じページに表示されるかどうかを取得します。
ITextRow::GetNestLevel テーブルの入れ子レベルを取得します。
ITextRow::GetProperty 指定されたプロパティの値を取得します。 (ITextRow.GetProperty)
ITextRow::GetRTL この行の向きが右から左であるかどうかを取得します。
ITextRow::Insert 関連付けられた ITextRange2 オブジェクトによって識別される場所に行 (行) を挿入します。
ITextRow::IsEqual 2 つのテーブル行を比較して、同じプロパティがあるかどうかを判断します。
ITextRow::Reset 行をリセットします。
ITextRow::SetAlignment 行の水平方向の配置を設定します。
ITextRow::SetCellAlignment アクティブ セルの垂直方向の配置を設定します。
ITextRow::SetCellBorderColors アクティブ セルの罫線の色を設定します。
ITextRow::SetCellBorderWidths アクティブ セルの罫線の幅を設定します。
ITextRow::SetCellColorBack アクティブ セルの背景色を設定します。
ITextRow::SetCellColorFore アクティブ セルの前景色を設定します。
ITextRow::SetCellCount 行内のセルの数を設定します。
ITextRow::SetCellCountCache 行にキャッシュされたセルの数を設定します。
ITextRow::SetCellIndex アクティブ セルのインデックスを設定します。
ITextRow::SetCellMargin 行のセル余白を設定します。
ITextRow::SetCellMergeFlags アクティブ セルのマージ フラグを設定します。
ITextRow::SetCellShading アクティブ セルの網かけを設定します。
ITextRow::SetCellVerticalText アクティブ セルの垂直テキスト設定を設定します。
ITextRow::SetCellWidth アクティブセルの幅を twip 単位で設定します。
ITextRow::SetHeight 行の高さを設定します。
ITextRow::SetIndent 行のインデントを設定します。
ITextRow::SetKeepTogether この行をページ間で分割できるかどうかを設定します。
ITextRow::SetKeepWithNext 行をその後の行と同じページに表示するかどうかを設定します。
ITextRow::SetProperty 指定したプロパティの値を設定します。 (ITextRow.SetProperty)
ITextRow::SetRTL この行の向きを右から左に設定するかどうかを設定します。

注釈

テーブル、行、またはセルを選択するには、 ITextRange::Expand を使用し、 Unit パラメーターをそれぞれ tomTable、 tomRow、または tomCell に設定します。 これらの単位は、 ITextRange::Move メソッドと共に使用して、複数の行またはセルを移動して選択することもできます。

一部の ITextRow プロパティは、行の配置など、行全体に適用されます。 さらに、 ITextRow::SetCellIndex メソッドを使用してインデックスが設定されたセルに適用される、セルの配置など、さまざまなプロパティがあります。 このセルはアクティブ セルと呼ばれます。

ITextRow は ITextPara2 と同様に機能しますが、ITextRow::Apply メソッドまたは ITextRow::Insert メソッドが呼び出されるまでドキュメントは変更されません。 さらに、行とセルのパラメーターは常にアクティブです。つまり、 tomDefault の値を持つことはできません。

初期化時に、 ITextRow オブジェクトは、関連付けられた ITextRange2 のアクティブな末尾にあるテーブル行プロパティ (存在する場合) を取得します。 ITextRow::Reset メソッドを使用して、これらのプロパティを ITextRange2 オブジェクトの現在の値に更新できます。

リッチ エディット コントロール テーブルは、一連のテーブル行で構成され、段落のシーケンスで構成されます。 テーブル行は、特殊な 2 文字区切り記号段落 U+FFF9 U+000D で始まり、2 文字区切り段落 U+FFFB U+000D で終わります。 各セルは、セル マーク U+0007 で終了します。これは、U+000D (CR) と同様に、段落末尾のハード マークとして扱われます。 テーブル行とセルのパラメーターは、テーブル行区切り記号の特殊な段落書式として扱われます。 セルパラメーターは、タブ配列の拡張バージョンに格納されます。 この形式では、テーブルを他のテーブル内に入れ子にすることができ、15 レベル深く移動できます。

アーキテクチャは、他の行のパラメーター (垂直マージ フラグを除く) に関係なく、各テーブル行に有効なテーブル行パラメーターを含めることができるという点で、非常に柔軟です。 たとえば、すべての行が同じインデントで始まる n×m の四角形の形式を持つ HTML とは異なり、テーブル行のセル数と開始インデントが異なる場合があります。

一方、テーブルの正式な説明はどこにも格納されません。 行数などの情報は、テーブル内を移動して把握する必要があります。 たとえば、ITextRange::StartOf (tomTable,tomFalse, NULL) を呼び出して現在のテーブルの先頭に移動し、ITextRange::Move (tomRow,tomForward, &dcRow) を呼び出すことで、テーブル内の行数を取得できます。 dcRow + 1&数量にはテーブル内の行数が含まれます。tomRow インクリメントによる移動は、最後のテーブル行を超えて移動しないためです。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	tom.h