AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones Procesador de texto / Tipos de variables
  • Propiedades específicas de las variables docFragment
  • Funciones WLanguage que utilizan variables docFragment
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
El tipo docFragment se utiliza para definir las características de un fragmento encontrado en un "docx" Document. Las características de este fragmento pueden definirse y modificarse mediante diferentes propiedades de WLanguage.
Un fragmento se define por su posición inicial y final. Por lo tanto, puede:
  • se extienden en varios párrafos,
  • empiezan en medio de cualquier palabra ordinaria,
  • terminan en medio de cualquier palabra ordinaria.
Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
Ejemplo
// Change the selection color
// Get the current selection
MySelection is docFragment(WP_MyDocument, WP_MyDocument.Cursor, ...
WP_MyDocument.SelectionLength)
// Change the color
MySelection.Formatting.TextColor = PastelRed
// Load the document
MyDoc is Document = "c:\temp\doc.docx"
 
// Adds text at the end of document
FragmentEnd is docFragment(MyDoc, -1 , 0)
FragmentEnd.Text += "End of document"
Sintaxis

Declarando un fragmento de Document que no está descrito Ocultar los detalles

MyVariable is docFragment
En este caso, el fragmento de Document no está descrito. La Variable tendrá que ser asignada con un fragmento existente o con el resultado de una de las funciones de tratamiento de documentos (DocSeek por ejemplo).

Declarar y describir un fragmento Ocultar los detalles

MyVariable is docFragment([<Document> [, <Start of fragment> [, <Length>]]])
<Document>: Documento opcional Variable o cadena de caracteres
Document de la que se extraerá un fragmento. Este documento corresponde a:
  • WINDEV el nombre de un control Procesador de texto.
  • una variable de tipo Document.
<Start of fragment>: Entero opcional
Posición inicial del fragmento de Document a utilizar. Esta posición se da en número de caracteres:
  • desde el comienzo de Document (número positivo).
  • desde el final de Document (número negativo).
<Length>: Entero opcional
Longitud del fragmento a utilizar, expresada en número de caracteres.
Observación: un número negativo le permite tomar un número de caracteres empezando desde el final: -1' = el final, '-2' = 1 carácter antes del final, etc.
Observaciones

Propiedades específicas de las variables docFragment

Las siguientes propiedades se pueden utilizar para manipular una variable de tipo docFragment:
Nombre de la propiedadTipo utilizadoEfecto
aspectoArray de docElementLos elementos que componen el fragmento de Document utilizado. Los elementos de los fragmentos se pueden navegar a través de la sentencia FOR EACH.
RangoIntegroNúmero de caracteres en el fragmento. Corresponde a la posición final menos la posición inicial.
La extensión puede corresponder a un valor positivo, negativo o cero..
Observaciones:
  • Si el fragmento contiene un tabla o una sección de un tabla, se cuentan todos los caracteres que contiene..
  • Si el fragmento contiene una Image o un área de texto, cada una corresponde a 1 carácter.
SubdocumentoIdentificadorIntegroIdentificador correspondiente al subdocumento associated con el fragmento. Esta Property está destinada a un uso avanzado.
LanguageSpellingCadena de caracteresEl lenguaje del fragmento. La notación utilizada corresponde a la norma 639-1. Por ejemplo "FR-fr".
En modo de lectura, esta Property devuelve una información válida sólo si el fragmento corresponde a un solo idioma.
Observación: Para realizar la corrección ortográfica correspondiente al idioma del fragmento, el diccionario de este idioma debe ser cargado por DictionaryLoad.
FormatoVariable de tipo docFormattingFormateo de la información de todos los elementos que componen el fragmento de Document utilizado.
PageLayoutDisposición del fragmento actual.
PageLayout.BackgroundColorIntegroFondo color de fragmento. Este color puede corresponder a:
PageLayout.BackgroundPatternVariable de tipo BackgroundCaracterísticas del fragmento Background.
PalabraArray de docFragmentLas palabras que conforman el fragmento de Document utilizado. Las palabras fragmentadas pueden ser hojeadas a través de la sentencia FOR EACH.
PárrafoArray de docParagraphPárrafos afectados por el fragmento (si un fragmento incluye varios párrafos). Los párrafos se pueden consultar a través de la sentencia FOR EACH.
Posición de inicioIntegroPosición inicial del fragmento. Esta posición es relativa a toda la Document.
Posición finalIntegroPosición final del fragmento. Esta posición es relativa a toda la Document.
StyleIDCadena de caracteresIdentificador de estilo aplicado al fragmento. Este identificador debe existir entre los estilos relacionado al Document.
Observación: Al cambiar el estilo de párrafo o de fragmento se aplica automáticamente el estilo de párrafo y el estilo de carácter de relacionado, si existen.
textoCadena de caracteresTexto en bruto correspondiente al contenido del fragmento utilizado.
TypeSubDocumentConstante de tipo IntegerSección de Document a la que pertenece el fragmento. Los valores posibles son:
  • typeSubDocCanvas: Contenedor Image
  • typeSubDocBody: Document cuerpo.
  • typeSubDocHeaderOddPage: Encabezado de página impar.
  • typeSubDocHeaderEvenPage: Encabezado de página par.
  • typeSubDocHeaderFirstPage: Cabecera de la primera Page.
  • typeSubDocFooterOddPage: Pie de página impar.
  • typeSubDocFooterEvenPage: Pie de página par.
  • typeSubDocFooterFirstPage: Pie de la primera Page.
  • typeSubDocTextArea: Área de texto.
Esta propiedad es de solo lectura.

Funciones WLanguage que utilizan variables docFragment

Las variables de docFragment son manejadas por varias funciones WLanguage:
  • Funciones WLanguage que utilizan sintaxis estándar:
    DocAddAgrega:
    • al final de un tratamiento de palabras Document: un elemento, una Document, un párrafo, un texto, una Image o un fragmento.
    • al final de un fragmento: un elemento, un texto o un Image.
    DocFindEncuentra una cadena de caracteres:
    • en un procesador de textos completo Document.
    • en un fragmento.
    DocInsertInserta un objeto en un procesador de textos Document o sustituye el contenido del fragmento actual. Los objetos que se pueden utilizar son:
    • un elemento,
    • a Document,
    • a paragraph,
    • un texto,
    • una imagen, etc,
    • un fragmento.
    DocInsertTableInserta una tabla en un procesador de textos Document.
    DocSelectSelecciona un fragmento de un control Procesador de texto.
  • Funciones de WLanguage que utilizan la sintaxis de los prefijos:
    .addAñade un elemento, texto o imagen al final de una docFragment Variable.
    .InsertReemplaza el contenido del fragmento actual. Los objetos que se pueden utilizar son:
    • un elemento,
    • a Document,
    • a paragraph,
    • un texto,
    • una imagen, etc,
    • un fragmento.
    .InsertTableSustituye el fragmento especificado por un tabla.
Versión mínima requerida
  • Versión 22
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/01/2023

Señalar un error o enviar una sugerencia | Ayuda local