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

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

継承

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

メソッド

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

注釈

テーブル、行、またはセルを選択するには、 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 インクリメントによる移動は、最後のテーブル行を超えて移動しないためです。

要件