flash.text.imeIIMEClient Interface des clients IME (éditeur de méthode d’entrée). Interface des clients IME (éditeur de méthode d’entrée). Les composants basés sur le package flash.text.engine doivent implémenter cette interface pour prendre en charge la modification intégrée de texte à l’aide d’un IME. Cette interface n’est pas utilisée avec des objets TextField. TextLayoutFramework (TLF) utilise cette interface pour prendre en charge l’IME intégré afin que les clients qui utilisent TLF n’aient pas à implémenter cette interface.

Pour prendre en charge l’IME intégré, définissez la propriété imeClient d’un événement ImeEvent.IME_START_COMPOSITION sur un objet qui implémente cette interface.

Les termes suivants sont souvent utilisés dans l’API associée à l’IME :

Une conversation est l’échange entre l’IME et l’application. Lors d’une conversation, une composition est mise à jour une ou plusieurs fois, puis confirmée par l’utilisateur.
Une composition identifie le texte saisi par l’utilisateur via l’IME, notamment les informations d’état, telles que la plage sélectionnée et l’étendue des clauses.
Une clause est une plage de la composition qui peut partager des informations sémantiques, c’est-à-dire indiquer si l’entrée est « sélectionnée » ou « convertie ». Une composition contient zéro ou plusieurs clauses.

textInput Distribué lorsque l’utilisateur saisit du texte.flash.events.TextEvent.TEXT_INPUTflash.events.TextEvent Distribué lorsque l’utilisateur saisit du texte. Pour les clients IME (éditeur de méthode d’entrée), le récepteur doit insérer la chaîne contenue dans la propriété text de l’objet d’événement au point d’insertion actuel. imeStartComposition Distribué lorsque l’utilisateur commence à utiliser un IME (éditeur de méthode d’entrée).flash.events.IMEEvent.IME_START_COMPOSITIONflash.events.IMEEvent Distribué lorsque l’utilisateur commence à utiliser un IME (éditeur de méthode d’entrée). confirmComposition Utilisez ce rappel pour mettre fin à la session de modification intégrée et confirmer le texte.textStringnull Etat final du texte dans la session intégrée (texte confirmé). preserveSelectionBooleanfalse si la valeur est définie sur true, il est préférable de ne pas réinitialiser la sélection en cours à la fin du texte confirmé. Utilisez ce rappel pour mettre fin à la session de modification intégrée et confirmer le texte. getTextBounds L’IME utilise cette méthode pour interroger le cadre de sélection du texte actuellement modifié à l’aide du client IME.Cadre de sélection de la plage de texte spécifiée ou null si l’un des index (ou les deux) n’est pas valide. Cette méthode renvoie la même valeur si la propriété startIndex est supérieure ou inférieure à endIndex. La même valeur doit être renvoyée, que la propriété startIndex soit supérieure ou inférieure à endIndex. flash.geom:RectanglestartIndexintEntier qui spécifie l’emplacement de départ de la plage de texte à partir du cadre de sélection que vous mesurez. endIndexintFacultatif ; entier qui spécifie l’emplacement de fin de la plage de texte à partir du cadre de sélection que vous mesurez. L’IME utilise cette méthode pour interroger le cadre de sélection du texte actuellement modifié à l’aide du client IME. Utilisez cette méthode pour placer la fenêtre candidate et définissez le curseur de la souris dans le client IME lorsque la souris survole le champ de texte ou un autre composant prenant en charge l’IME. getTextInRange Récupère la plage de texte spécifiée à partir du composant.Le texte requis, ou null si aucun texte n’est disponible dans la plage requise, ou si l’un des index (ou les deux) n’est pas valide. La même valeur doit être renvoyée, que startIndex soit supérieur ou inférieur à endIndex. StringstartIndexintEntier qui spécifie l’emplacement de départ de la plage de texte à extraire. endIndexintEntier qui spécifie l’emplacement de fin de la plage de texte à extraire. Récupère la plage de texte spécifiée à partir du composant. Cette méthode est appelé au cours de la reconversion de l’IME. selectRange Définit la plage de texte sélectionnée dans le composant.anchorIndexintValeur d’index de base zéro du caractère à l’extrémité d’ancrage de la sélection activeIndexintValeur d’index de base zéro du caractère à l’extrémité active de la sélection. Définit la plage de texte sélectionnée dans le composant. Si l’un des arguments est hors limites, la sélection ne doit pas être modifiée. updateComposition Rappel pour la mise à jour du contenu de la session de modification intégrée.textString Contient le texte de la session de modification intégrée à partir de l’IME. attributes Contient un tableau de clauses de composition avec des informations d’ornement. compositionStartIndexint Début de la session intégrée par rapport au début de l’objet de texte. compositionEndIndexint Fin de la session intégrée par rapport au début de l’objet de texte. Rappel pour la mise à jour du contenu de la session de modification intégrée. Cette méthode est appelée lorsque le texte actuellement modifié avec l’IME a changé et que son contenu est utilisé par le client pour recréer l’ensemble de la session de modification intégrée. compositionEndIndex Valeur d’index de base zéro du caractère à la fin de la session de modification de texte actuelle (c’est-à-dire l’ensemble du texte dans la session intégrée qui n’est pas confirmé au document).int Valeur d’index de base zéro du caractère à la fin de la session de modification de texte actuelle (c’est-à-dire l’ensemble du texte dans la session intégrée qui n’est pas confirmé au document). compositionStartIndex Valeur d’index de base zéro du caractère au début de la session de modification de texte actuelle (c’est-à-dire l’ensemble du texte dans la session intégrée qui n’est pas confirmé au document).int Valeur d’index de base zéro du caractère au début de la session de modification de texte actuelle (c’est-à-dire l’ensemble du texte dans la session intégrée qui n’est pas confirmé au document). selectionActiveIndex Valeur d’index de base zéro du dernier caractère de la sélection actuelle.int Valeur d’index de base zéro du dernier caractère de la sélection actuelle. selectionAnchorIndex Valeur d’index de base zéro du premier caractère de la sélection actuelle.int Valeur d’index de base zéro du premier caractère de la sélection actuelle. verticalTextLayout Indique si le texte dans le composant est vertical ou non.Boolean Indique si le texte dans le composant est vertical ou non. Cette propriété indique le positionnement de la fenêtre candidate (par exemple, à côté du texte vertical ou en dessous du texte horizontal). CompositionAttributeRange La classe CompositionAttributeRange représente une plage d’attributs de composition pour une utilisation avec des événements d’IME (éditeur de méthode d’entrée).Object La classe CompositionAttributeRange représente une plage d’attributs de composition pour une utilisation avec des événements d’IME (éditeur de méthode d’entrée). Par exemple, lors de la modification de texte dans l’IME, le texte est divisé par l’IME en plages de composition. Ces plages de composition sont marquées à l’aide d’indicateurs au fur et à mesure qu’elle sont sélectionnées (notamment lorsqu’elles sont rallongées, raccourcies ou modifiées) et/ou converties (c’est-à-dire lorsqu’elles sont déjà passées par une recherche dans le dictionnaire de l’IME).

Par convention, le client doit orner ces plages de composition en les soulignant ou en les mettant en surbrillance en fonction des indicateurs.

Par exemple :

!converted = thick gray underline (raw text) !selected && converted = thin black underline selected && converted = thick black underline CompositionAttributeRange Crée un objet CompositionAttributeRange.relativeStartint Index de base zéro du premier caractère inclus dans la plage de caractères. relativeEndint Index de base zéro du dernier caractère inclus dans la plage de caractères. selectedBoolean Définit la clause de composition actuelle comme active ou non. convertedBoolean Définit la clause actuelle comme traitée par l’IME et en attente de confirmation de la part de l’utilisateur. Constructeur associé aux objets CompositionAttributeRange. Crée un objet CompositionAttributeRange. converted Une propriété qui définit la clause actuelle a été traitée par l’IME et la clause est en attente de validation ou de confirmation de la part de l’utilisateur. Boolean Une propriété qui définit la clause actuelle a été traitée par l’IME et la clause est en attente de validation ou de confirmation de la part de l’utilisateur. relativeEnd Position de la fin de la clause de composition, par rapport au début de la session de modification intégrée. int Position de la fin de la clause de composition, par rapport au début de la session de modification intégrée. Par exemple, une valeur de 0 correspond au début du texte que lit l’IME (du texte peut toutefois exister avant cette position dans le champ de modification). relativeStart La position de départ relative à partir du début de la session de modification intégrée. int La position de départ relative à partir du début de la session de modification intégrée. Par exemple, une valeur de 0 correspond au début du texte que lit l’IME (du texte peut toutefois exister avant cette position dans le champ de modification). selected Une propriété définissant la clause de composition actuelle est active et rallongée, raccourcie ou modifiée à l’aide de l’IME alors que les clauses de voisinage ne changent pas. Boolean Une propriété définissant la clause de composition actuelle est active et rallongée, raccourcie ou modifiée à l’aide de l’IME alors que les clauses de voisinage ne changent pas.