Saltar al contenido principal
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 propiedadITextBlock::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 objetosy 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 propiedaddel objeto ImageProcessingParams. Para especificar la orientación del texto en un bloque de texto concreto, establezca la propiedadantes 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 propiedadsea igual a RT_UnknownRotation o cuya propiedadsea igual a TRT_Unknown no puede asignarse a esta propiedad.

Métodos

NombreDescripción
AppendEmptyParagraphAñade un párrafo vacío al final del texto actual.
GetRangeDevuelve una copia de un rango de texto.
RemoveElimina un rango del texto actual.
RemoveAllElimina todos los párrafos del texto actual.
Text Diagrama de objetos

Parámetro de entrada

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

Ejemplos

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:

Consulte también

Trabajar con texto Trabajar con propiedades