Bookmark.InsertCrossReference メソッド

定義

名前空間:

Microsoft.Office.Tools.Word

アセンブリ:

Microsoft.Office.Tools.Word.dll

見出し、ブックマーク、注釈、文末脚注、または図表番号のラベルが定義された項目 (数式、図形、表など) への相互参照を Bookmark コントロールに挿入します。

public void InsertCrossReference (ref object ReferenceType, Microsoft.Office.Interop.Word.WdReferenceKind ReferenceKind, ref object ReferenceItem, ref object InsertAsHyperlink, ref object IncludePosition, ref object SeparateNumbers, ref object SeparatorString);

abstract member InsertCrossReference : obj * Microsoft.Office.Interop.Word.WdReferenceKind * obj * obj * obj * obj * obj -> unit

Public Sub InsertCrossReference (ByRef ReferenceType As Object, ReferenceKind As WdReferenceKind, ByRef ReferenceItem As Object, Optional ByRef InsertAsHyperlink As Object, Optional ByRef IncludePosition As Object, Optional ByRef SeparateNumbers As Object, Optional ByRef SeparatorString As Object)

パラメーター

ReferenceType

Object

相互参照を挿入する項目の種類。 WdReferenceType 定数、WdCaptionLabelID 定数、またはユーザー定義の図表番号のラベルを何でも指定できます。

ReferenceKind

WdReferenceKind

相互参照に含める情報。

ReferenceItem

Object

が のwdRefTypeBookmark場合ReferenceType、この引数はブックマーク名を指定します。 その他 ReferenceType のすべての値に対して、この引数は、[相互参照] ダイアログ ボックスの [参照の種類] ボックスの項目番号または名前を指定します。 この引数に使用できる項目名の一覧を取得するには、GetCrossReferenceItems(Object) メソッドを使用します。

InsertAsHyperlink

Object

相互参照を、参照される項目へのハイパーリンクとして挿入する場合は true、それ以外の場合は false。

IncludePosition

Object

相互参照と参照項目との位置関係に応じて、上または下を挿入する場合は true。

SeparateNumbers

Object

関連するテキストから番号を区切るために区切り記号を使用する場合は true (パラメーターが ReferenceType に設定され、 ReferenceKind パラメーターが にwdRefTypeNumberedItemwdNumberFullContext設定されている場合にのみ使用します)。

SeparatorString

Object

パラメーターが に設定されている場合に区切り記号として使用する SeparateNumbers 文字列を true指定します。

例

次のコード例では、コントロールを使用して見出しとテキストを Bookmark 文書に追加し、見出しテキストへの相互参照を挿入します。

この例は、ドキュメント レベルのカスタマイズ用です。

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);
}

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

注釈

のReferenceKind値に を指定wdPageNumberした場合は、正しい相互参照情報を表示するために、ドキュメントを改ページする必要がある場合があります。

省略可能のパラメーター

省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。