Trabajando con Marcas
Marcas identificadas en un Microsoft Word documentar los lugares o fragmentos que usted nombre e identifique para referencia futura. Por ejemplo, podría utilizar un marcador para identificar texto que desea revisar más adelante. En lugar de desplazarse a través del documento para localizar el texto, puede ir a él utilizando el cuadro de diálogo Bookmark.
Con Aspose.Words, puede utilizar marcadores en informes o documentos para insertar algunos datos en el marcador o aplicar formato especial a su contenido. También puede utilizar marcadores para recuperar texto de una determinada ubicación en su documento.
Las acciones que se pueden realizar con marcadores utilizando Aspose.Words son los mismos que los que puedes realizar usando Microsoft Word. Puede insertar un nuevo marcador, eliminar, mover a un marcador, obtener o establecer un nombre de marcadores, obtener o establecer texto adjunto en él.
Insertar un marcador
Uso startBookmark y endBookmark crear un marcador marcando su inicio y fin, respectivamente. No te olvides de pasar el mismo nombre marcador a ambos métodos. Los marcadores en un documento pueden superponerse y abarcar cualquier rango. Los marcadores o marcadores mal formados con nombres duplicados serán ignorados cuando se guarda el documento.
El siguiente ejemplo de código muestra cómo crear un nuevo marcador:
Obtenga marcadores
A veces es necesario obtener una colección de marcadores para iterar a través de marcadores o para otros fines. Usar el Node.getRange propiedad expuesta por cualquier nodo de documento que devuelva Range objeto que representa la parte del documento contenida en este nodo. Utilice este objeto para recuperar un BookmarkCollection y luego utilizar el indexador de la colección para obtener un marcador específico.
El siguiente ejemplo de código muestra cómo obtener marcadores de una colección de marcadores:
El siguiente ejemplo de código muestra cómo obtener o establecer un nombre y texto marcador:
El siguiente ejemplo de código muestra cómo marcar una tabla:
Si cambia el nombre de un marcador a un nombre que ya existe en el documento, no se generará ningún error y sólo se almacenará el primer marcador cuando guarde el documento.
Tenga en cuenta que algunos marcadores en el documento se asignan a campos de forma. Moviéndose a tal marcador e insertando texto, inserta el texto en el código de campo de formularios. Aunque esto no invalidará el campo de forma, el texto insertado no será visible porque se convierte en parte del código de campo.
El siguiente ejemplo de código muestra cómo acceder a las columnas de la tabla reservada:
Muévete a un marcador
Si necesita insertar contenido rico (no sólo texto simple) en un marcador, debe utilizar moveToBookmark para mover el cursor al marcador y luego utilizar DocumentBuilder métodos y propiedades para insertar contenido.
Mostrar Ocultar el contenido de Bookmark
Todo el Bookmark (* incluyendo el contenido marcado*) puede ser encapsulado dentro de la parte Verdadera de la IF campo utilizando Aspose.Words. Puede ser de tal manera que IF campo contiene un campo de fusión anidado en la expresión (*izquierda de operador*) y dependiendo del valor del campo de fusión, el IF campo muestra o oculta el contenido de Bookmark en Word Document.
El siguiente ejemplo de código muestra cómo mostrar/ ocultar marcadores.