> ## 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.

# Objet TextEditor (interface ITextEditor)

> Objet TextEditor (interface ITextEditor) dans les composants visuels d’ABBYY FineReader Engine sous Windows — l’objet TextEditor est un contrôle ActiveX qui permet d’afficher et de modifier le texte reconnu sur une page de document.

<Warning>
  Les composants visuels sont implémentés dans FRE pour Windows.
</Warning>

L’objet TextEditor est un contrôle ActiveX qui permet d’afficher et de modifier le texte reconnu sur une page de document. Une page est associée au composant via la propriété FRPage.

Le composant Text Editor se présente comme suit :

<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" />

Vous pouvez modifier l’apparence du composant via ses propriétés. Par exemple, vous pouvez ajouter des boutons à sa barre d’outils ou en supprimer via la propriété Toolbar, ou encore modifier le menu contextuel du composant via la propriété Commands. Voir [Personnalisation du menu contextuel et de la barre d’outils d’un composant visuel](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component) pour plus de détails.

Les informations relatives à la modification du texte reconnu sont transmises par des interfaces sortantes spéciales. Ces interfaces sont [ITextEditorEvents](/fr/fine-reader/engine/visual-components-reference/itexteditorevents) (pour C++) et la dispinterface [DITextEditorEvents](/fr/fine-reader/engine/visual-components-reference/itexteditorevents) (pour Visual Basic).

Il convient de noter que les utilisateurs de Visual Basic n’ont pas à se soucier des détails d’implémentation des interfaces d’événement, car cette plateforme de développement fournit des moyens simples de les gérer. Cet objet peut être déclaré avec WithEvents dans Visual Basic.

Pour l’utilisateur C++, cela signifie qu’il prend en charge l’interface IConnectionPointContainer. Pour recevoir des notifications d’événement, l’utilisateur C++ doit créer un objet dérivé de l’interface ITextEditorEvents, puis établir la connexion entre celui-ci et la source d’événements implémentée dans l’objet TextEditor à l’aide des mécanismes COM standard.

Le composant Text Editor peut être connecté au composant [Component Synchronizer](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer), auquel cas tous les événements de Text Editor seront automatiquement transmis aux autres composants connectés au Synchronizer et l’ensemble de l’application fonctionnera de manière synchrone.

<div id="properties">
  ## Propriétés
</div>

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

      <th>
        <p>
          <strong>Type</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <a name="bottompaneenabled" />

          <strong>BottomPaneEnabled</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si le volet inférieur de Text Editor est activé. Si cette
          propriété est FALSE, le volet inférieur n'est pas affiché.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

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

          <strong>CaptionPaneEnabled</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si le volet de légende de Text Editor est activé. Si cette
          propriété est FALSE, le volet de légende n'est pas affiché.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

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

          <strong>ContextMenuEnabled</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si le menu contextuel de Text Editor est activé. Si cette
          propriété est FALSE, le menu contextuel n'est jamais affiché.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>
          Donne accès aux commandes disponibles dans Text Editor. Voir{" "}

          <a href="/fr/fine-reader/engine/visual-components-reference/texteditor/text-editor-commands">
            la liste des commandes disponibles dans Text Editor
          </a>

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

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

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

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

      <td>
        <p>Indique la position du curseur sur la page.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Représente la page du document connectée à Text Editor.</p>
      </td>
    </tr>

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

          <strong>KeepTextAndBackgroundColor</strong>
        </p>
      </td>

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

      <td>
        <p>
          Indique si les couleurs du texte et de l'arrière-plan doivent être
          conservées dans Text Editor.
        </p>

        <p>Par défaut, la valeur de cette propriété est TRUE.</p>
      </td>
    </tr>

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

          <strong>Locked</strong>
        </p>
      </td>

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

      <td>
        <p>Indique si Text Editor est verrouillé.</p>
        <p>Cette propriété est utile dans les situations suivantes :</p>

        <ul>
          <li>
            une opération d'analyse, de reconnaissance, de synthèse ou d'export est appelée depuis
            l'API FineReader Engine (et non depuis Visual Components), ou
          </li>

          <li>
            votre application reçoit des notifications de certains événements (par exemple,
            depuis l'objet

            <strong>
              {" "}

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

              {" "}
            </strong>

            ) et traite les messages Windows de Visual Components dans ces gestionnaires d'événements.
          </li>
        </ul>

        <p>
          Dans ce cas, il est recommandé de définir cette propriété sur TRUE avant
          l'analyse, la reconnaissance, la synthèse ou l'export, et de la définir sur FALSE une fois
          l'opération terminée. Le document ne peut ainsi pas être altéré
          depuis Text Editor.
        </p>

        <p>Par défaut, la valeur est FALSE.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Indique l'un des modes d'affichage du document.</p>
        <p>Par défaut, la valeur est TEM\_ExactCopy.</p>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>Donne accès aux paramètres du menu contextuel.</p>
      </td>
    </tr>

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

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

      <td>
        <p>
          Spécifie le chemin d'accès au dossier contenant les fichiers de
          paramètres de l'éditeur de texte. Les autres composants visuels
          disposent de la même propriété. Chaque composant visuel doit utiliser
          son propre dossier de paramètres.
        </p>

        <p>
          La valeur de cette propriété est construite à partir du chemin d'accès
          au dossier dans lequel ABBYY FineReader Engine stocke les données
          propres à l'utilisateur, et du nom de son sous-dossier. Par défaut,
          le dossier contenant les données propres à l'utilisateur est le{" "}

          <a href="/fr/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            dossier de données FineReader Engine
          </a>

          . Il peut être modifié lors de l'initialisation de FineReader Engine
          (via la fonction{" "}

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

          {" "}

          ou via la méthode{" "}

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

          ). Le nom par défaut du sous-dossier est un GUID arbitraire.
          Pour modifier le nom du sous-dossier, spécifiez le nouveau nom dans
          les propriétés du composant dans Visual Studio au moment de la
          conception. Si vous tentez de définir la valeur de la propriété au
          moment de l'exécution, cette valeur est ignorée.
        </p>

        <p>
          Si vous ajoutez le composant à un formulaire dans Visual Studio lors
          de la conception, la valeur de la propriété est définie soit
          automatiquement avec la valeur par défaut, soit manuellement avec une
          valeur personnalisée. Dans les deux cas, la valeur est définie au
          moment de la conception. Si, pour une raison quelconque, la valeur de
          la propriété n'est pas définie au moment de la conception (par
          exemple, si vous générez le composant dynamiquement au moment de
          l'exécution), le composant crée un nouveau dossier de paramètres à
          chaque initialisation. Pour éviter la prolifération des dossiers,
          supprimez le dossier de paramètres créé après la désinitialisation du
          composant. Dans ce cas, vous ne pouvez utiliser que les paramètres par
          défaut du composant et ne pouvez pas enregistrer les paramètres d'une
          session à l'autre.
        </p>
      </td>
    </tr>

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

          <strong>ShowPictures</strong>
        </p>
      </td>

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

      <td>
        <p>Spécifie si les images doivent être affichées dans l'éditeur de texte.</p>
        <p>Par défaut, la valeur de cette propriété est TRUE.</p>
      </td>
    </tr>

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

          <strong>ShowRunningTitles</strong>
        </p>
      </td>

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

      <td>
        <p>
          Spécifie si les titres courants doivent être affichés dans l'éditeur de texte.
        </p>

        <p>Par défaut, la valeur de cette propriété est TRUE.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Spécifie les paramètres de synthèse par défaut pour un document. Ces
          paramètres sont utilisés lorsque l'éditeur de texte doit effectuer une
          synthèse de document (ce qui peut se produire si la structure logique
          d'un document devient incorrecte suite à certaines opérations
          d'édition).
        </p>

        <Note>
          Si l'éditeur de texte est connecté au synchroniseur de composants,
          utilisez la propriété{" "}

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

          {" "}

          pour modifier les paramètres utilisés pour la synthèse de document.
          Si vous modifiez ces paramètres via la propriété de l'éditeur de
          texte, des erreurs risquent de se produire.
        </Note>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>
          Stocke les coordonnées du rectangle du caractère courant en pixels.
          Les coordonnées sont relatives à l'image du document.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Spécifie le titre du composant éditeur de texte.</p>
        <p>Par défaut, sa valeur est "Text".</p>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>Donne accès aux paramètres de la barre d'outils.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Spécifie l'échelle de la page de texte en pourcentage.
          Cette propriété peut également être définie sur l'une des constantes{" "}

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

          .
        </p>

        <p>
          Par défaut, la valeur est ST\_BestFit, ce qui signifie que le meilleur ajustement
          est sélectionné automatiquement.
        </p>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>
          Stocke les coordonnées de la zone visible du document en pixels. Les
          coordonnées sont relatives à l'image du document.
        </p>
      </td>
    </tr>

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

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

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

          , lecture seule
        </p>
      </td>

      <td>
        <p>Renvoie le handle de fenêtre de la zone client.</p>
      </td>
    </tr>
  </tbody>
</table>

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

| Nom                                                                                                                 | Description                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [ActivateOn](/fr/fine-reader/engine/visual-components-reference/texteditor/activateon-method)                       | Active une position dans le bloc spécifié et la rend visible à l’écran.                                                                                                                                                                                                           |
| [CenterOnDocumentPoint](/fr/fine-reader/engine/visual-components-reference/texteditor/centerondocumentpoint-method) | Fait défiler la vue de texte afin que le point spécifié du document soit placé au centre de la vue.                                                                                                                                                                               |
| [DocumentToScreen](/fr/fine-reader/engine/visual-components-reference/texteditor/documenttoscreen-method)           | Convertit les coordonnées du point spécifié sur l’image du document en coordonnées d’écran.                                                                                                                                                                                       |
| [GetSelection](/fr/fine-reader/engine/visual-components-reference/texteditor/getselection-method)                   | Renvoie les positions de début et de fin de la sélection.                                                                                                                                                                                                                         |
| [Print](/fr/fine-reader/engine/visual-components-reference/texteditor/print-method)                                 | Imprime le texte reconnu.                                                                                                                                                                                                                                                         |
| [SetSelection](/fr/fine-reader/engine/visual-components-reference/texteditor/setselection-method)                   | Définit la sélection de texte sur une page.                                                                                                                                                                                                                                       |
| [ScreenToDocument](/fr/fine-reader/engine/visual-components-reference/texteditor/screentodocument-method)           | Convertit les coordonnées d’écran du point spécifié en coordonnées sur l’image du document.                                                                                                                                                                                       |
| [ShowBlock](/fr/fine-reader/engine/visual-components-reference/texteditor/showblock-method)                         | Fait apparaître le bloc spécifié à l’écran (dans la mesure du possible). Cette méthode n’a de sens que si Text Editor est utilisé en mode [TEM\_ExactCopy](/fr/fine-reader/engine/visual-components-reference/enumerations/texteditormodeenum).                                   |
| [ShowDocumentArea](/fr/fine-reader/engine/visual-components-reference/texteditor/showdocumentarea-method)           | Fait défiler la vue de texte afin que la zone du document correspondant aux coordonnées spécifiées devienne visible (dans la mesure du possible).                                                                                                                                 |
| [UpdateOptions](/fr/fine-reader/engine/visual-components-reference/texteditor/updateoptions-method)                 | Met à jour les paramètres spécifiés dans la boîte de dialogue Options de Text Editor. Vous devrez peut-être appeler cette méthode si les options ont été modifiées dans un autre composant visuel, afin de mettre à jour les options de Text Editor en fonction de l’état actuel. |

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

Ce composant est utilisé dans les exemples de code suivants : [VisualComponents](/fr/fine-reader/engine/guided-tour/samples#visualcomponents).

<div id="see-also">
  ## Voir aussi
</div>

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

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

[Création d’une application avec une interface graphique](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)

[Personnalisation du menu contextuel et de la barre d’outils d’un composant visuel](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component)