> ## 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 TextEditor (interfaz ITextEditor)

> Objeto TextEditor (interfaz ITextEditor) en ABBYY FineReader Engine Visual Components para Windows — El objeto TextEditor es un control ActiveX que le permite ver y editar el texto reconocido en una página de documento.

<Warning>
  Visual Components está implementado en FRE para Windows.
</Warning>

El objeto TextEditor es un control ActiveX que le permite ver y editar el texto reconocido en una página de un documento. Una página se conecta al componente mediante la propiedad FRPage.

El componente Text Editor tiene este aspecto:

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/texteditor.gif?s=ce55edc06b02d96dd62837dfdcc1a705" alt="TextEditor" width="559" height="351" data-path="images/fine-reader/engine/texteditor.gif" />

Puede modificar la apariencia del componente mediante sus propiedades. Por ejemplo, puede agregar botones a su barra de herramientas y quitarlos mediante la propiedad Toolbar, o modificar el menú contextual del componente mediante la propiedad Commands. Consulte [personalización del menú contextual y la barra de herramientas de un Visual Component](/es/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component) para obtener más información.

La información sobre la edición del texto reconocido se transmite a través de interfaces salientes especiales. Estas interfaces son [ITextEditorEvents](/es/fine-reader/engine/visual-components-reference/itexteditorevents) (para C++) y una dispinterface [DITextEditorEvents](/es/fine-reader/engine/visual-components-reference/itexteditorevents) (para Visual Basic).

Cabe señalar que los usuarios de Visual Basic no necesitan preocuparse por los detalles de implementación de las interfaces de eventos, ya que esta plataforma de desarrollo proporciona mecanismos sencillos para controlarlas. Este objeto puede declararse con WithEvents en Visual Basic.

Para el usuario de C++, esto significa que admite la interfaz IConnectionPointContainer. Para recibir notificaciones de eventos, un usuario de C++ debe crear un objeto derivado de la interfaz ITextEditorEvents y, a continuación, establecer la conexión entre este y el origen de eventos implementado en el objeto TextEditor mediante los mecanismos COM estándar.

El componente Text Editor puede conectarse al componente [Component Synchronizer](/es/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer); en ese caso, todos los eventos de Text Editor se transmitirán automáticamente a otros componentes conectados al Synchronizer y toda la aplicación funcionará de forma sincronizada.

<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>
          <a name="bottompaneenabled" />

          <strong>BottomPaneEnabled</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 el panel inferior del Text Editor está habilitado. Si esta
          propiedad es FALSE, el panel inferior no se muestra.
        </p>

        <p>De forma predeterminada, el valor es TRUE.</p>
      </td>
    </tr>

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

          <strong>CaptionPaneEnabled</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 el panel de título del Text Editor está habilitado. Si esta
          propiedad es FALSE, el panel de título no se muestra.
        </p>

        <p>De forma predeterminada, el valor es TRUE.</p>
      </td>
    </tr>

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

          <strong>ContextMenuEnabled</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 el menú contextual del Text Editor está habilitado. Si esta
          propiedad es FALSE, el menú contextual nunca se muestra.
        </p>

        <p>De forma predeterminada, el valor es TRUE.</p>
      </td>
    </tr>

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

          <strong>Commands</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/supplementary-objects/commands">
              Commands
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Proporciona acceso a los comandos disponibles en Text Editor. Consulte{" "}

          <a href="/es/fine-reader/engine/visual-components-reference/texteditor/text-editor-commands">
            la lista de comandos disponibles en Text Editor
          </a>

          .
        </p>
      </td>
    </tr>

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

          <strong>CursorPosition</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/supplementary-objects/editorposition">
              EditorPosition
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Especifica la posición del cursor en la página.</p>
      </td>
    </tr>

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

          <strong>FRPage</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/api-reference/document-related-objects/frpage">
              FRPage
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Representa la página del documento conectada al Text Editor.</p>
      </td>
    </tr>

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

          <strong>KeepTextAndBackgroundColor</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 del texto y del fondo deben conservarse en
          el Text Editor.
        </p>

        <p>De forma predeterminada, el valor de esta propiedad es TRUE.</p>
      </td>
    </tr>

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

          <strong>Locked</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 el Text Editor está bloqueado.</p>
        <p>Esta propiedad resulta útil en las siguientes situaciones:</p>

        <ul>
          <li>
            se invoca una operación de análisis, reconocimiento, síntesis o exportación desde
            la API de FineReader Engine (no desde Visual Components), o
          </li>

          <li>
            la aplicación recibe notificaciones de ciertos eventos (por ejemplo,
            del objeto

            <strong>
              {" "}

              <a href="/es/fine-reader/engine/api-reference/document-related-objects/frdocument">
                FRDocument
              </a>

              {" "}
            </strong>

            ) y procesa mensajes de Windows de Visual Components en
            los controladores de dichos eventos.
          </li>
        </ul>

        <p>
          En este caso, se recomienda establecer esta propiedad en TRUE antes del
          análisis, reconocimiento, síntesis o exportación, y en FALSE al
          finalizar la operación. De este modo, el documento no podrá modificarse
          desde el Text Editor.
        </p>

        <p>De forma predeterminada, el valor es FALSE.</p>
      </td>
    </tr>

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

          <strong>Mode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/enumerations/texteditormodeenum">
              TextEditorModeEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Especifica uno de los modos de visualización del documento.</p>
        <p>De forma predeterminada, el valor es TEM\_ExactCopy.</p>
      </td>
    </tr>

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

          <strong>PopupMenu</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/supplementary-objects/popupmenu">
              PopupMenu
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>Proporciona acceso a la configuración del menú contextual.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>SettingsPath</strong>
        </p>
      </td>

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

      <td>
        <p>
          Especifica la ruta a la carpeta que contiene los archivos con la
          configuración del Editor de texto. Los demás Visual Components tienen la misma
          propiedad. Cada Visual Component debe usar su propia carpeta de
          configuración.
        </p>

        <p>
          El valor de esta propiedad se construye a partir de la ruta a la carpeta
          en la que ABBYY FineReader Engine almacena los datos específicos del usuario, y el
          nombre de su subcarpeta. De forma predeterminada, la carpeta con datos específicos del usuario
          es la{" "}

          <a href="/es/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            carpeta de datos de FineReader Engine
          </a>

          . Puede modificarse durante la inicialización de FineReader Engine (mediante
          la función{" "}

          <strong>
            <a href="/es/fine-reader/engine/api-reference/functions/initializeengine-function">
              InitializeEngine
            </a>
          </strong>

          {" "}

          o mediante el método{" "}

          <strong>
            <a href="/es/fine-reader/engine/api-reference/engine-loaders/iengineloader/initializeengine-method">
              IEngineLoader::InitializeEngine
            </a>
          </strong>

          ). El nombre predeterminado de la subcarpeta es un GUID arbitrario. Para
          cambiar el nombre de la subcarpeta, debe especificar el nuevo nombre en
          las propiedades del componente en Visual Studio en tiempo de diseño. Si
          intenta especificar el valor de la propiedad en tiempo de ejecución, dicho valor
          se ignorará.
        </p>

        <p>
          Si agrega el componente a un formulario en Visual Studio durante el diseño,
          el valor de la propiedad se define automáticamente con el
          valor predeterminado o manualmente con un valor personalizado. En ambos casos, el
          valor se define en tiempo de diseño. Si por algún motivo el valor de la
          propiedad no se define en tiempo de diseño (por ejemplo, si genera el
          componente dinámicamente en tiempo de ejecución), el componente crea una nueva carpeta
          de configuración cada vez que se inicializa. Para evitar
          la proliferación de carpetas, debe eliminar la carpeta de configuración creada
          tras la desinicialización del componente. En este caso, solo puede usar
          la configuración predeterminada del componente y no es posible guardar la
          configuración entre sesiones.
        </p>
      </td>
    </tr>

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

          <strong>ShowPictures</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 las imágenes deben mostrarse en el Editor de texto.</p>
        <p>De forma predeterminada, el valor de esta propiedad es TRUE.</p>
      </td>
    </tr>

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

          <strong>ShowRunningTitles</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 títulos corrientes deben mostrarse en el Editor de texto.
        </p>

        <p>De forma predeterminada, el valor de esta propiedad es TRUE.</p>
      </td>
    </tr>

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

          <strong>SynthesisParamsForDocument</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsfordocument">
              SynthesisParamsForDocument
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Especifica los parámetros de síntesis predeterminados para un documento. Estos
          parámetros se utilizan cuando el Editor de texto necesita realizar la síntesis del documento
          (esto puede ocurrir si la estructura lógica de un documento queda
          incorrecta a causa de ciertas operaciones de edición).
        </p>

        <Note>
          Si el Editor de texto está conectado al Sincronizador de componentes, use la propiedad{" "}

          <a href="/es/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#processingparams">
            IComponentSynchronizer::ProcessingParams
          </a>

          {" "}

          para cambiar los parámetros utilizados en la síntesis del documento. Si
          cambia estos parámetros mediante la propiedad del Editor de texto, pueden
          producirse errores.
        </Note>
      </td>
    </tr>

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

          <strong>SymbolRect</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle">
              FRRectangle
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Almacena las coordenadas del rectángulo del carácter actual en píxeles.
          Las coordenadas son relativas a la imagen del documento.
        </p>
      </td>
    </tr>

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

          <strong>Title</strong>
        </p>
      </td>

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

      <td>
        <p>Especifica el título del componente Editor de texto.</p>
        <p>De forma predeterminada, es "Text".</p>
      </td>
    </tr>

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

          <strong>Toolbar</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/supplementary-objects/toolbar">
              Toolbar
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>Proporciona acceso a la configuración de la barra de herramientas.</p>
      </td>
    </tr>

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

          <strong>ViewScale</strong>
        </p>
      </td>

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

      <td>
        <p>
          Especifica la escala de la página de texto en puntos porcentuales. Esta
          propiedad también puede establecerse en una de las constantes de{" "}

          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/enumerations/scaletypes">
              ScaleTypes
            </a>
          </strong>

          {" "}

          constants.
        </p>

        <p>
          De forma predeterminada, el valor es ST\_BestFit, lo que significa que el mejor ajuste
          se selecciona automáticamente.
        </p>
      </td>
    </tr>

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

          <strong>VisibleDocumentArea</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle">
              FRRectangle
            </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>
          Almacena las coordenadas del área visible del documento en píxeles. Las
          coordenadas son relativas a la imagen del documento.
        </p>
      </td>
    </tr>

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

          <strong>WindowHandle</strong>
        </p>
      </td>

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

          , de solo lectura
        </p>
      </td>

      <td>
        <p>Devuelve el identificador de ventana del área de cliente.</p>
      </td>
    </tr>
  </tbody>
</table>

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

| Nombre                                                                                                              | Descripción                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [ActivateOn](/es/fine-reader/engine/visual-components-reference/texteditor/activateon-method)                       | Activa una posición en el bloque especificado y la desplaza hasta hacerla visible.                                                                                                                                                                                    |
| [CenterOnDocumentPoint](/es/fine-reader/engine/visual-components-reference/texteditor/centerondocumentpoint-method) | Desplaza la vista de texto para que el punto del documento especificado quede situado en el centro de la vista.                                                                                                                                                       |
| [DocumentToScreen](/es/fine-reader/engine/visual-components-reference/texteditor/documenttoscreen-method)           | Convierte las coordenadas del punto especificado en la imagen del documento en coordenadas de pantalla.                                                                                                                                                               |
| [GetSelection](/es/fine-reader/engine/visual-components-reference/texteditor/getselection-method)                   | Devuelve las posiciones inicial y final del cursor de la selección.                                                                                                                                                                                                   |
| [Print](/es/fine-reader/engine/visual-components-reference/texteditor/print-method)                                 | Imprime el texto reconocido.                                                                                                                                                                                                                                          |
| [SetSelection](/es/fine-reader/engine/visual-components-reference/texteditor/setselection-method)                   | Establece la selección de texto en una página.                                                                                                                                                                                                                        |
| [ScreenToDocument](/es/fine-reader/engine/visual-components-reference/texteditor/screentodocument-method)           | Convierte las coordenadas de pantalla del punto especificado en coordenadas de la imagen del documento.                                                                                                                                                               |
| [ShowBlock](/es/fine-reader/engine/visual-components-reference/texteditor/showblock-method)                         | Desplaza el bloque especificado hasta hacerlo visible (en la medida de lo posible). Este método solo tiene sentido si el Text Editor se usa en el modo [TEM\_ExactCopy](/es/fine-reader/engine/visual-components-reference/enumerations/texteditormodeenum).          |
| [ShowDocumentArea](/es/fine-reader/engine/visual-components-reference/texteditor/showdocumentarea-method)           | Desplaza la vista de texto para que el área del documento con las coordenadas especificadas pase a ser visible (en la medida de lo posible).                                                                                                                          |
| [UpdateOptions](/es/fine-reader/engine/visual-components-reference/texteditor/updateoptions-method)                 | Actualiza la configuración especificada en el cuadro de diálogo Opciones del Text Editor. Puede que sea necesario llamar a este método si las opciones se han cambiado en algún otro Visual Component, para actualizar las opciones del Text Editor al estado actual. |

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

Este componente se utiliza en los siguientes ejemplos de código: [VisualComponents](/es/fine-reader/engine/guided-tour/samples#visualcomponents).

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

[ITextEditorEvents](/es/fine-reader/engine/visual-components-reference/itexteditorevents)

[IComponentSynchronizer::TextEditor](/es/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#texteditor)

[Crear una aplicación con interfaz gráfica de usuario](/es/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)

[Personalizar el menú contextual y la barra de herramientas de un Visual Component](/es/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component)