| Package | flash.text.ime |
| Interface | public interface IIMEClient |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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.
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
| compositionEndIndex : int [lecture seule]
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). | IIMEClient | ||
| compositionStartIndex : int [lecture seule]
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). | IIMEClient | ||
| selectionActiveIndex : int [lecture seule]
Valeur d’index de base zéro du dernier caractère de la sélection actuelle. | IIMEClient | ||
| selectionAnchorIndex : int [lecture seule]
Valeur d’index de base zéro du premier caractère de la sélection actuelle. | IIMEClient | ||
| verticalTextLayout : Boolean [lecture seule]
Indique si le texte dans le composant est vertical ou non. | IIMEClient | ||
| Méthode | Défini par | ||
|---|---|---|---|
Utilisez ce rappel pour mettre fin à la session de modification intégrée et confirmer le texte. | IIMEClient | ||
L’IME utilise cette méthode pour interroger le cadre de sélection du texte actuellement modifié à l’aide du client IME. | IIMEClient | ||
Récupère la plage de texte spécifiée à partir du composant. | IIMEClient | ||
Définit la plage de texte sélectionnée dans le composant. | IIMEClient | ||
updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void
Rappel pour la mise à jour du contenu de la session de modification intégrée. | IIMEClient | ||
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| Distribué lorsque l’utilisateur commence à utiliser un IME (éditeur de méthode d’entrée). | IIMEClient | |||
| Distribué lorsque l’utilisateur saisit du texte. | IIMEClient | |||
compositionEndIndex | propriété |
compositionEndIndex:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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).
Implémentation
public function get compositionEndIndex():intcompositionStartIndex | propriété |
compositionStartIndex:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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).
Implémentation
public function get compositionStartIndex():intselectionActiveIndex | propriété |
selectionAnchorIndex | propriété |
verticalTextLayout | propriété |
verticalTextLayout:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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).
Implémentation
public function get verticalTextLayout():BooleanconfirmComposition | () | méthode |
public function confirmComposition(text:String = null, preserveSelection:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Utilisez ce rappel pour mettre fin à la session de modification intégrée et confirmer le texte.
Paramètres
text:String (default = null) | |
preserveSelection:Boolean (default = false) |
getTextBounds | () | méthode |
public function getTextBounds(startIndex:int, endIndex:int):Rectangle| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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.
Paramètres
startIndex:int — Entier qui spécifie l’emplacement de départ de la plage de texte à partir du cadre de sélection que vous mesurez.
| |
endIndex:int — Facultatif ; entier qui spécifie l’emplacement de fin de la plage de texte à partir du cadre de sélection que vous mesurez.
|
Rectangle — 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.
|
getTextInRange | () | méthode |
public function getTextInRange(startIndex:int, endIndex:int):String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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.
Paramètres
startIndex:int — Entier qui spécifie l’emplacement de départ de la plage de texte à extraire.
| |
endIndex:int — Entier qui spécifie l’emplacement de fin de la plage de texte à extraire.
|
String — 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.
|
selectRange | () | méthode |
public function selectRange(anchorIndex:int, activeIndex:int):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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.
Paramètres
anchorIndex:int — Valeur d’index de base zéro du caractère à l’extrémité d’ancrage de la sélection
| |
activeIndex:int — Valeur d’index de base zéro du caractère à l’extrémité active de la sélection.
|
updateComposition | () | méthode |
public function updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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.
Paramètres
text:String — Contient le texte de la session de modification intégrée à partir de l’IME.
| |
attributes:Vector.<CompositionAttributeRange> — Contient un tableau de clauses de composition avec des informations d’ornement.
| |
compositionStartIndex:int — Début de la session intégrée par rapport au début de l’objet de texte.
| |
compositionEndIndex:int — Fin de la session intégrée par rapport au début de l’objet de texte.
|
imeStartComposition | Evénement |
flash.events.IMEEventpropriété IMEEvent.type =
flash.events.IMEEvent.IME_START_COMPOSITION| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Distribué lorsque l’utilisateur commence à utiliser un IME (éditeur de méthode d’entrée).
Pour gérer la saisie de texte IME, le récepteur doit définir le champimeClient de l’événement sur un objet qui implémente l’interface IIMEClient. Si le champ imeClient n’est pas défini, le moteur d’exécution utilise plutôt la composition IME hors ligne et transmet la composition finale en tant qu’événement TEXT_INPUT.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | L’objet IME. |
textInput | Evénement |
flash.events.TextEventpropriété TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
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.
type d’un objet événement textInput.
Remarque : cet événement n’est pas distribué pour les touches Supprimer ou Retour arrière.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | true ; appelez la méthode preventDefault() pour annuler le comportement par défaut. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Champ de texte dans lequel sont entrés des caractères. La cible ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement. |
text | Caractère ou série de caractères entré par l’utilisateur. |
Tue Jun 12 2018, 09:30 AM Z