Aspose::Pdf::Text::TextFragment clase

TextFragment class

Representa un fragmento de texto Pdf.

class TextFragment : public Aspose::Pdf::BaseParagraph

Métodos

Método	Descripción
Clone() override	Clona el fragmento.
virtual CloneWithSegments()	Clona el fragmento con todos los segmentos.
get_BaselinePosition()	Obtiene la posición del texto, representado con el objeto TextFragment. El YIndent de la estructura Position representa la coordenada de la línea base del fragmento de texto.
get_EndNote() const	Obtiene la nota final del párrafo (solo para generación de pdf).
get_FootNote() const	Obtiene la nota al pie del párrafo (solo para generación de pdf).
get_Form() const	Obtiene el objeto de formulario que contiene el TextFragment.
get_HorizontalAlignment() override	Obtiene una alineación horizontal del fragmento de texto.
get_Page() const	Obtiene la página que contiene el TextFragment.
get_Position()	Obtiene la posición del texto, representado con el objeto TextFragment.
get_Rectangle()	Obtiene el rectángulo del TextFragment.
get_ReplaceOptions() const	Obtiene las opciones de reemplazo de texto. Las opciones definen el comportamiento cuando el texto del fragmento se reemplaza por uno más corto o más largo.
get_Segments() const	Obtiene los segmentos de texto del TextFragment actual.
get_Text()	Obtiene el objeto de texto System::String que representa el objeto TextFragment.
get_TextEditOptions() const	Obtiene las opciones de edición de texto. Las opciones definen un comportamiento especial cuando el símbolo solicitado no puede ser escrito con la fuente.
get_TextState()	Obtiene el estado del texto para el texto que representa el objeto TextFragment.
get_VerticalAlignment() override	Obtiene una alineación vertical del fragmento de texto.
get_WrapLinesCount() const	Obtiene el recuento de líneas de ajuste para este párrafo (solo para generación de pdf).
IsolateTextSegments(int32_t, int32_t)	Obtiene TextSegment(s) que representan la parte especificada del texto del TextFragment.
set_BaselinePosition(const System::SharedPtr<Aspose::Pdf::Text::Position>&)	Obtiene la posición del texto, representado con el objeto TextFragment. El YIndent de la estructura Position representa la coordenada de la línea base del fragmento de texto.
set_EndNote(const System::SharedPtr<Note>&)	Establece la nota final del párrafo (solo para generación de pdf).
set_FootNote(const System::SharedPtr<Note>&)	Establece la nota al pie del párrafo (solo para generación de pdf).
set_HorizontalAlignment(Aspose::Pdf::HorizontalAlignment) override	Establece una alineación horizontal del fragmento de texto.
set_Hyperlink(System::SharedPtr<Aspose::Pdf::Hyperlink>) override	Establece el hipervínculo del fragmento.
set_Position(const System::SharedPtr<Aspose::Pdf::Text::Position>&)	Establece la posición del texto, representado con el objeto TextFragment.
set_Segments(const System::SharedPtr<TextSegmentCollection>&)	Obtiene los segmentos de texto del TextFragment actual.
set_Text(const System::String&)	Establece el objeto de texto System::String que representa el objeto TextFragment.
set_TextEditOptions(const System::SharedPtr<Aspose::Pdf::Text::TextEditOptions>&)	Establece las opciones de edición de texto. Las opciones definen un comportamiento especial cuando el símbolo solicitado no puede ser escrito con la fuente.
set_VerticalAlignment(Aspose::Pdf::VerticalAlignment) override	Establece una alineación vertical del fragmento de texto.
set_WrapLinesCount(int32_t)	Establece la cantidad de líneas de ajuste para este párrafo (solo para generación de PDF).
TextFragment()	Inicializa una nueva instancia del objeto TextFragment.
TextFragment(const System::SharedPtr<TabStops>&)	Inicializa una nueva instancia del objeto TextFragment con posiciones predefinidas de TabStops.
TextFragment(const System::String&)	Crea un objeto TextFragment con un único objeto TextSegment dentro. Especifica la cadena de texto dentro del segmento.
TextFragment(const System::String&, const System::SharedPtr<TabStops>&)	Crea un objeto TextFragment con un único objeto TextSegment dentro y posiciones predefinidas de TabStops.

Observaciones

En pocas palabras, el objeto TextFragment contiene una lista de objetos TextSegment.

En detalle: el Text del documento PDF en Aspose::Pdf está representado por dos objetos básicos: TextFragment y TextSegment.

Las diferencias entre ellos son mayormente dependientes del contexto.

Consideremos el siguiente escenario. El usuario busca el texto “hello world” para operar con él, cambiar sus propiedades, verlo, etc.

Document doc = new Document(docFile);
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");
doc.Pages[1].Accept(absorber);

La representación física del texto PDF es muy compleja. El texto “hello world” puede consistir en varios segmentos de texto físicamente independientes.

El modelo de texto de Aspose.Pdf establece básicamente que el objeto TextFragment proporciona un conjunto de operaciones lógicas sobre el conjunto de objetos TextSegment físicos que representan la consulta del usuario.

En el escenario de búsqueda de texto, TextFragment es la representación lógica del texto “hello world”, y la colección de objetos TextSegment representa todos los segmentos físicos que construyen el objeto de texto “hello world”.

Así, TextFragment se acerca a la representación lógica del texto. Y TextSegment se acerca a la representación física del texto.

Obviamente, cada objeto TextSegment puede tener su propia fuente, coloración y propiedades de posicionamiento.

TextFragment provides simple way to change text with it’s properties: set font, set font size, set font color etc. Meanwhile TextSegment objects are accessible and users are able to operate with TextSegment objects independently.

Note that changing TextFragment properties may change inner Segments collection because TextFragment is an aggregate object and it may rearrange internal segments or merge them into single segment. If your requirement is to leave the Segments collection unchanged, please change inner segments individually.

Ver también

Clase Aspose::Pdf::Text::TextFormattingOptions Clase Aspose::Pdf::Text::TextFragmentAbsorber