Bookmark.InsertCrossReference (Método)
Inserta en un control Bookmark una referencia cruzada a un encabezado, un marcador, una nota a pie de página, una nota al final o a un elemento para el que se haya definido una etiqueta de título (por ejemplo, una ecuación, una figura o una tabla).
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
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
)
Parámetros
- ReferenceType
Tipo: System.Object%
Tipo de elemento para el que se inserta una referencia cruzada.Puede ser cualquier constante WdReferenceType o WdCaptionLabelID, o una etiqueta de título definida por el usuario.
- ReferenceKind
Tipo: Microsoft.Office.Interop.Word.WdReferenceKind
Información que se va a incluir en la referencia cruzada.
- ReferenceItem
Tipo: System.Object%
Si ReferenceType es wdRefTypeBookmark, este argumento especifica un nombre de marcador.Para el resto de valores de ReferenceType, este argumento especifica el número o nombre del elemento en el cuadro Tipo de referencia del cuadro de diálogo Referencia cruzada.Utilice el método GetCrossReferenceItems para devolver una lista de nombres de elemento que se pueden utilizar con este argumento.
- InsertAsHyperlink
Tipo: System.Object%
true, para insertar la referencia cruzada como un hipervínculo al elemento de referencia; de lo contrario, false.
- IncludePosition
Tipo: System.Object%
true, para realizar la inserción antes o después en función de la ubicación del elemento de referencia con respecto a la referencia cruzada.
- SeparateNumbers
Tipo: System.Object%
true, para utilizar un separador que separe los números del texto asociado.Utilícelo sólo si el parámetro ReferenceType se establece en wdRefTypeNumberedItem y el parámetro ReferenceKind en wdNumberFullContext.
- SeparatorString
Tipo: System.Object%
Especifica la cadena que se va a utilizar como separador si el parámetro SeparateNumbers está definido en true.
Comentarios
Si especifica wdPageNumber como valor de ReferenceKind, podría necesitar repaginar el documento para ver la información de la referencia cruzada correcta.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente agrega un encabezado y texto al documento utilizando controles Bookmark y, a continuación, inserta una referencia cruzada al texto del encabezado.
Se trata de un ejemplo para una personalización en el nivel del documento.
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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.