Langue

Bidi.SetContext(String, String) Méthode

Définition

Définissez le contexte avant un appel à setPara().

[Android.Runtime.Register("setContext", "(Ljava/lang/String;Ljava/lang/String;)V", "GetSetContext_Ljava_lang_String_Ljava_lang_String_Handler", ApiSince=29)]
public virtual void SetContext(string? prologue, string? epilogue);
[<Android.Runtime.Register("setContext", "(Ljava/lang/String;Ljava/lang/String;)V", "GetSetContext_Ljava_lang_String_Ljava_lang_String_Handler", ApiSince=29)>]
abstract member SetContext : string * string -> unit
override this.SetContext : string * string -> unit

Paramètres

prologue
String

est le texte qui précède le texte qui sera spécifié dans un appel à venir à setPara(). S’il n’existe aucun prologue à prendre en compte, ce paramètre peut être null.

epilogue
String

est le texte qui suit le texte qui sera spécifié dans un appel à venir à setPara(). S’il n’y a pas d’épilogue à prendre en compte, ce paramètre peut être null.

Attributs

Remarques

Définissez le contexte avant un appel à setPara().

setPara() calcule la direction de gauche à droite d’un élément de texte donné qui est fourni comme l’un de ses arguments. Parfois, ce texte (le « texte principal ») doit être considéré dans le contexte, car le texte apparaissant avant (« prologue ») et/ou après (« épilogue ») peut affecter le résultat de ce calcul.

Cette fonction spécifie le prologue et/ou l’épilogue pour l’appel suivant à setPara(). Si les appels successifs à setPara() nécessitent toutes la spécification d’un contexte, setContext() doit être appelé avant chaque appel à setPara(). En d’autres termes, un contexte n’est pas « mémorisé » après l’appel suivant pour setPara().

Si un appel à setPara() spécifie DEFAULT_LTR ou DEFAULT_RTL en tant que paraLevel et est précédé d’un appel à setContext() qui spécifie un prologue, le niveau de paragraphe est calculé en tenant compte du texte du prologue.

Lorsque setPara() est appelé sans appel précédent à setContext, le texte principal est géré comme s’il était précédé et suivi de caractères directionnels forts au niveau du paragraphe actuel. L’appel de setContext() avec spécification d’un prologue modifie ce comportement en gérant le texte principal comme s’il précède le dernier caractère fort apparaissant dans le prologue, le cas échéant. L’appel de setContext() avec spécification d’un épilogue modifie le comportement de setPara() en gérant le texte principal comme si suivi du premier caractère fort ou chiffre apparaissant dans l’épilogue, le cas échéant.

Remarque 1 : si setContext elle est appelée à plusieurs reprises sans appel setPara, les appels précédents n’ont aucun effet, seul le dernier appel sera mémorisé pour l’appel suivant à setPara.

Remarque 2 : l’appel setContext(null, null) annule tout paramètre précédent de prologue ou d’épilogue non vide. L’appel suivant ne setPara() traitera pas de prologue ou d’épilogue.

Remarque 3 : les utilisateurs doivent savoir que même après avoir défini le contexte avant un appel à setPara() pour effectuer une transformation logique à visuelle, la chaîne résultante peut ne pas être identique à ce qu’elle aurait été si tout le texte, y compris le prologue et l’épilogue, avaient été traités ensemble.<br> Exemple (lettres majuscules représentent les caractères RTL) :< br>   ;   ; prologue = « abc DE"<br>   ;   ; epilogue = none<br>   ;   ; texte principal = « FGH xyz"<br>   ;   ; paraLevel = LTR<br>   ;   ; display sans prologue = « HGF xyz » (« HGF » est adjacent à « xyz »)<br>   ;   ; display with prologue = « abc HGFED xyz » (« HGF » n’est pas adjacent à « xyz »)<br>

Java documentation pour android.icu.text.Bidi.setContext(java.lang.String, java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à