Objeto Text (interfaz IText)

Este objeto representa texto reconocido. El texto reconocido es una colección de párrafos. El acceso a esta colección se proporciona mediante la propiedad Paragraphs. Además, este objeto expone propiedades para acceder a distintos atributos del texto y métodos que permiten realizar operaciones con él, como la división vertical y horizontal, la eliminación de rangos, etc. El objeto Text puede existir de forma independiente o ser un subobjeto de otro objeto que represente una unidad de disposición (bloque de texto, celda de tabla, etc.). Una posición en el texto se define mediante el “par de coordenadas” (párrafo;símbolo). También existe la llamada “posición especial”, para la cual paragraph=<el número de párrafos>, symbol=0.

Se puede acceder a este objeto a través de un bloque reconocido con texto. También puede acceder al texto reconocido completo del documento o de la página en un formato especial de “texto sin formato” mediante el objeto PlainText.

​

Propiedades

	, de solo lectura	Devuelve el objeto Engine.
		Especifica si los colores de todo el texto están invertidos. Este atributo se establece en TRUE si el texto reconocido pertenece a un bloque o celda de tabla que también tiene el atributo de inversión. Puede utilizarse en la interfaz de usuario para mostrar el texto con fuente blanca sobre fondo negro. Solo puede editar esta propiedad si el objeto Text se recibió a través de la propiedad ITextBlock::Text . De lo contrario, la propiedad es de solo lectura.
	, de solo lectura	Proporciona acceso a la colección de párrafos del objeto Text. Cada objeto Text, incluso uno vacío, contiene un subobjeto válido de tipo Paragraphs . Este objeto es una colección de objetos y puede no contener ningún elemento. El objeto Paragraph representa un párrafo en el texto reconocido. El contenido del texto reconocido se obtiene a través de este objeto.
		Almacena la orientación del texto. Es utilizado internamente por ABBYY FineReader Engine al exportar el texto reconocido. Esta propiedad solo es significativa después del reconocimiento; no obstante, no es posible cambiar la orientación del texto que ya ha sido reconocido. Si desea especificar la orientación de la página antes del reconocimiento, utilice la propiedad del objeto ImageProcessingParams. Para especificar la orientación del texto en un bloque de texto concreto, establezca la propiedad antes del reconocimiento. El único caso en el que es necesario establecer el valor de esta propiedad es cuando se desea insertar texto adicional que debe aparecer en el archivo exportado. Tras añadir dicho texto, especifique su orientación con ayuda de esta propiedad y llame al método que realice la síntesis antes de exportar el documento. Notas: La propiedad devuelve un objeto constante. Para cambiar la orientación del texto, primero debe obtener un objeto TextOrientation intermedio mediante el método , modificar los parámetros necesarios y, a continuación, asignar el objeto obtenido a la propiedad. Solo puede editar esta propiedad si el objeto Text se recibió a través de la propiedad . De lo contrario, la propiedad es de solo lectura. El objeto TextOrientation cuya propiedad sea igual a RT_UnknownRotation o cuya propiedad sea igual a TRT_Unknown no puede asignarse a esta propiedad.

​

Métodos

Nombre	Descripción
AppendEmptyParagraph	Añade un párrafo vacío al final del texto actual.
GetRange	Devuelve una copia de un rango de texto.
Remove	Elimina un rango del texto actual.
RemoveAll	Elimina todos los párrafos del texto actual.

​

Objetos relacionados

Diagrama de objetos

​

Parámetro de entrada

Este objeto corresponde al parámetro de entrada del método InsertText del objeto Paragraph.

​

Ejemplos

Código C#

FREngine.IBlock block;
int suspiciousCharsCount = 0;
// Recorre los párrafos de un bloque de texto y obtiene el texto
FREngine.ITextBlock textBlock = block.GetAsTextBlock();
int paragraphsCount = textBlock.Text.Paragraphs.Count;
for (int iPar = 0; iPar < paragraphsCount; iPar++)
{
 FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
 string text = par.Text;
 // hacer algo con el texto
}

El objeto se utiliza en los siguientes ejemplos de código:

• Linux: CustomLanguage
• Windows: CustomLanguage, RecognizedTextProcessing; y en las herramientas de demostración: Perfiles de procesamiento predefinidos del motor

​

Consulte también

Trabajar con texto

Trabajar con propiedades