> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Text (interfaz IText)

> Objeto Text (interfaz IText) en la API de ABBYY FineReader Engine — representa texto reconocido como una colección de párrafos; las posiciones se definen mediante pares de coordenadas (párrafo; símbolo); expone IsInverted y TextOrientation.

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.

<Note>
  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](/es/fine-reader/engine/api-reference/text-related-objects/plaintext).
</Note>

<div id="properties">
  ## Propiedades
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Nombre</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Tipo</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Descripción</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>Application</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>
          </strong>

          ,{" "}

          <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            de solo lectura
          </a>
        </p>
      </td>

      <td>
        <p>
          Devuelve el objeto <strong>Engine</strong>.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>IsInverted</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          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.
        </p>

        <Note>
          Solo puede editar esta propiedad si el objeto Text se recibió a través de
          la propiedad{" "}

          <a href="/es/fine-reader/engine/api-reference/layout-related-objects/textblock#text">
            ITextBlock::Text
          </a>

          {" "}

          . De lo contrario, la propiedad es de solo lectura.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="paragraphs" />

          <strong>Paragraphs</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/api-reference/text-related-objects/paragraphs">
              Paragraphs
            </a>
          </strong>

          ,{" "}

          <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            de solo lectura
          </a>
        </p>
      </td>

      <td>
        <p>
          Proporciona acceso a la colección de párrafos del objeto{" "}
          <strong>Text</strong>. Cada objeto <strong>Text</strong>, incluso
          uno vacío, contiene un subobjeto válido de tipo{" "}
          <strong>Paragraphs </strong>. Este objeto es una colección de objetos{" "}

          <strong>
            <a href="/es/fine-reader/engine/api-reference/text-related-objects/paragraph">
              Paragraph
            </a>
          </strong>

          {" "}

          y puede no contener ningún elemento. El objeto{" "}
          <strong>Paragraph </strong>representa un párrafo en el
          texto reconocido. El contenido del texto reconocido se obtiene a través de este objeto.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="textorientation" />

          <strong>TextOrientation</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/api-reference/text-related-objects/textorientation">
              TextOrientation
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Almacena la orientación del texto. Es utilizado internamente por ABBYY
          FineReader Engine al exportar el texto reconocido.
        </p>

        <p>
          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{" "}

          <strong>
            <a href="/es/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams#rotationtype">
              RotationType
            </a>
          </strong>

          {" "}

          del objeto <strong>ImageProcessingParams</strong>. Para
          especificar la orientación del texto en un bloque de texto concreto, establezca la propiedad{" "}

          <strong>
            <a href="/es/fine-reader/engine/api-reference/layout-related-objects/textblock#textorientation">
              ITextBlock::TextOrientation
            </a>
          </strong>

          {" "}

          antes del reconocimiento.
        </p>

        <p>
          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.
        </p>

        <p>Notas:</p>

        <ul>
          <li>
            La propiedad devuelve un objeto constante. Para cambiar la orientación del texto,
            primero debe obtener un objeto <strong>TextOrientation</strong> intermedio mediante el método{" "}

            <strong>
              <a href="/es/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods">
                IEngine::CreateTextOrientation
              </a>
            </strong>

            {" "}

            , modificar los parámetros necesarios y, a continuación, asignar el
            objeto obtenido a la propiedad.
          </li>

          <li>
            Solo puede editar esta propiedad si el objeto <strong>Text</strong>
            se recibió a través de la propiedad{" "}

            <strong>
              <a href="/es/fine-reader/engine/api-reference/layout-related-objects/textblock#text">
                ITextBlock::Text
              </a>
            </strong>

            {" "}

            . De lo contrario, la propiedad es de solo lectura.
          </li>

          <li>
            El objeto <strong>TextOrientation</strong> cuya propiedad{" "}

            <strong>
              <a href="/es/fine-reader/engine/api-reference/text-related-objects/textorientation#rotationtype">
                RotationType
              </a>
            </strong>

            {" "}

            sea igual a RT\_UnknownRotation o cuya propiedad{" "}

            <strong>
              <a href="/es/fine-reader/engine/api-reference/text-related-objects/textorientation#readingtype">
                ReadingType
              </a>
            </strong>

            {" "}

            sea igual a TRT\_Unknown no puede asignarse a esta
            propiedad.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Métodos
</div>

| Nombre                                                                                                             | Descripción                                       |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| [AppendEmptyParagraph](/es/fine-reader/engine/api-reference/text-related-objects/text/appendemptyparagraph-method) | Añade un párrafo vacío al final del texto actual. |
| [GetRange](/es/fine-reader/engine/api-reference/text-related-objects/text/getrange-method)                         | Devuelve una copia de un rango de texto.          |
| [Remove](/es/fine-reader/engine/api-reference/text-related-objects/text/remove-method)                             | Elimina un rango del texto actual.                |
| [RemoveAll](/es/fine-reader/engine/api-reference/text-related-objects/text/removeall-method)                       | Elimina todos los párrafos del texto actual.      |

<div id="related-objects">
  ## Objetos relacionados
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/text.gif?s=d5cc47e13de30be27cc4bc41076d5491" alt="Text" width="314" height="160" data-path="images/fine-reader/engine/text.gif" />[](/es/fine-reader/engine/api-reference/layout-related-objects/textblock#text)[](/es/fine-reader/engine/api-reference/text-related-objects/paragraph)[](/es/fine-reader/engine/api-reference/text-related-objects/paragraphs)[](/es/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/es/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#editabletext)[](/es/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/es/fine-reader/engine/api-reference/layout-related-objects/textblock)

[Diagrama de objetos](/es/fine-reader/engine/api-reference/object-diagram)

<div id="input-parameter">
  ## Parámetro de entrada
</div>

Este objeto corresponde al parámetro de entrada del método [InsertText](/es/fine-reader/engine/api-reference/text-related-objects/paragraph/inserttext-method) del objeto [Paragraph](/es/fine-reader/engine/api-reference/text-related-objects/paragraph).

<div id="samples">
  ## Ejemplos
</div>

<Accordion title="Código C#">
  ```csharp theme={null}
  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
  }
  ```
</Accordion>

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

* Linux: [CustomLanguage](/es/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/es/fine-reader/engine/guided-tour/samples#customlanguage), [RecognizedTextProcessing](/es/fine-reader/engine/guided-tour/samples#recognizedtextprocessing); y en las herramientas de demostración: [Perfiles de procesamiento predefinidos del motor](/es/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

<div id="see-also">
  ## Consulte también
</div>

[Trabajar con texto](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-text)

[Trabajar con propiedades](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)