Shape.AddRows メソッド (Visio)

シェイプシート セクションの指定された位置に、指定された数の行を追加します。

構文

expression. AddRows( _Section_ , _Row_ , _RowTag_ , _RowCount_ )

式Shape オブジェクトを表す変数。

パラメーター

戻り値

整数

注釈

シェイプシートのセクションが存在しない場合は、AddRows メソッドによって、空白の行を含むセクションが作成されます。 新しい行の新しいセルは、既定の数式で初期化されます (数式が適用できる場合)。 初期化できない場合は、新しいセルの数式を設定するステートメントをプログラムに記述する必要があります。 行を追加できない場合は、エラーが発生します。

RowTag に指定できる定数は、Visio タイプ ライブラリの VisRowIndices で宣言されています。

Visio タイプ ライブラリによって宣言された行定数は、セクションの行が始まる基本位置として機能します。 これらの定数にオフセットを追加して、最初の行以降 (visRowFirst +0、visRowFirst + 1 など) を指定します。 セクションの末尾に行を追加するには、Row 引数に定数 visRowLast を渡します。 返される値は、実際の行インデックスです。

引数 RowTag は、追加する行の種類を指定します。 セクションの既定の行の種類を生成するには、visTagDefault (0) を引数 RowTag として渡します。 [Geometry]、[Connection Points]、[Controls] の各セクションに行を追加するときには、明示的なタグを使用すると便利です。 これらのセクションで有効な行の種類については、RowType プロパティを参照してください。 無効な種類の行を渡すとエラーが生成されます。

[Character]、[Tabs]、[Paragraph] セクションに行を追加しようとすると、エラーが発生します。

AddRows メソッドは名前付きの行を追加できません。 名前付きの行を追加するには、AddNamedRow メソッドを使用します。

名前付きの行を含むセクション ([Connection Points] セクションや [Controls] セクションなど) に行を追加する場合、Row 引数は無視されます。 既定値では、名前付きの行は、追加された順に、Row_1、Row_2 などの名前が付けられます。 名前の順序は、既存の行または直前に削除された行に左右されます。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。