Bookmark.InsertCrossReference メソッド
見出し、ブックマーク、注釈、文末脚注、または図表番号のラベルが定義された項目 (数式、図形、表など) への相互参照を Bookmark コントロールに挿入します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)
構文
'宣言
Sub InsertCrossReference ( _
ByRef ReferenceType As Object, _
ReferenceKind As WdReferenceKind, _
ByRef ReferenceItem As Object, _
ByRef InsertAsHyperlink As Object, _
ByRef IncludePosition As Object, _
ByRef SeparateNumbers As Object, _
ByRef SeparatorString As Object _
)
void InsertCrossReference(
ref Object ReferenceType,
WdReferenceKind ReferenceKind,
ref Object ReferenceItem,
ref Object InsertAsHyperlink,
ref Object IncludePosition,
ref Object SeparateNumbers,
ref Object SeparatorString
)
パラメーター
- ReferenceType
型 : System.Object%
相互参照を挿入する項目の種類。WdReferenceType 定数、WdCaptionLabelID 定数、またはユーザー定義の図表番号のラベルを何でも指定できます。
- ReferenceKind
型 : Microsoft.Office.Interop.Word.WdReferenceKind
相互参照に含める情報。
- ReferenceItem
型 : System.Object%
ReferenceType が wdRefTypeBookmark の場合、この引数にはブックマークの名前を指定します。それ以外のすべての ReferenceType 値の場合、この引数には [相互参照] ダイアログ ボックスの [参照の種類] ボックスにある項目番号または項目名を指定します。この引数に使用できる項目名の一覧を取得するには、GetCrossReferenceItems メソッドを使用します。
- InsertAsHyperlink
型 : System.Object%
相互参照を、参照される項目へのハイパーリンクとして挿入する場合は true、それ以外の場合は false。
- IncludePosition
型 : System.Object%
相互参照と参照項目との位置関係に応じて、上または下を挿入する場合は true。
- SeparateNumbers
型 : System.Object%
関連するテキストから番号を区切るために区切り記号を使用する場合は true(ReferenceTypeパラメーターに wdRefTypeNumberedItem を設定し、ReferenceKind パラメーターに wdNumberFullContext を設定する場合にだけ使用します)。
- SeparatorString
型 : System.Object%
SeparateNumbers パラメーターに true を設定した場合は、区切り記号として使用する文字列を指定します。
解説
ReferenceKind の値に wdPageNumber を指定した場合は、文書のページ番号を付け直して、相互参照の情報が正しいかを確認することが必要になる場合もあります。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
次のコード例は、Bookmark コントロールを使用して見出しとテキストを文書に追加し、見出しのテキストにクロス リファレンスを挿入します。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。
Private Sub BookmarkInsertCrossReference()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
Bookmark1.Text = "Heading of Document"
Bookmark1.Style = "Heading 1"
Bookmark1.Delete()
Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(2).Range, "Bookmark2")
Bookmark2.Text = "This is sample bookmark text: "
Bookmark2.Words.Last.InsertCrossReference("Heading", _
Word.WdReferenceKind.wdContentText, "1", True, _
False, False, " ")
End Sub
private void BookmarkInsertCrossReference()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Bookmark bookmark1 =
this.Controls.AddBookmark(this.Paragraphs[1].Range,
"bookmark1");
bookmark1.Text = "Heading of Document";
bookmark1.Style = "Heading 1";
bookmark1.Delete();
Microsoft.Office.Tools.Word.Bookmark bookmark2 =
this.Controls.AddBookmark(this.Paragraphs[2].Range,
"bookmark2");
bookmark2.Text = "This is sample bookmark text: ";
object ReferenceType = "Heading";
object ReferenceItem = "1";
object InsertAsHyperlink = true;
object IncludePosition = false;
object SeparateNumbers = false;
object SeparatorString = " ";
bookmark2.Words.Last.InsertCrossReference(ref ReferenceType,
Word.WdReferenceKind.wdContentText, ref ReferenceItem,
ref InsertAsHyperlink, ref IncludePosition,
ref SeparateNumbers, ref SeparatorString);
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。