Bidi.SetContext(String, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在呼叫 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
參數
- prologue
- String
是即將呼叫 setPara() 時將指定的文字前的文字。
若無序言可考慮,此參數可為 null。
- epilogue
- String
是接著在即將呼叫 setPara() 時指定的文字後面的文字。
若無尾聲可考慮,此參數可為 null。
- 屬性
備註
在呼叫 setPara() 之前,先設定上下文。
setPara() 計算給定文本的左右方向性,該文本作為其參數之一。 有時這段文字(「主文」)應放在上下文中考慮,因為出現在主文字之前(「序言」)和/或後(「尾聲」)的文字,可能會影響計算結果。
此函式指定下一次呼叫 setPara() 的序言和/或結語。 若連續呼叫 setPara() 皆需指定上下文,則必須在每次呼叫 setPara() 前先呼叫 setContext()。 換句話說,在成功呼叫 setPara() 後,上下文不會被「記憶」。
若呼叫 setPara() 時指定 DEFAULT_LTR 或 DEFAULT_RTL 為 paraLevel,且前方呼叫 setContext() 指定序言,則會根據序言中的文字來計算段落層級。
當 setPara() 未先呼叫 setContext 時,主文會被視為當前段落層級的強方向字元前後處理。 呼叫 setContext() 並指定序章,會改變此行為,將主文視為序言中最後出現的強字元(若有的話)處理。 若呼叫 setContext() 並指定結語,則會改變 setPara() 的行為,因為它會將主文視為後面出現第一個強字元或數字(如果有的話)。
註 1:若 setContext 在未呼叫 setPara的情況下反覆呼叫 ,先前的呼叫無效,只有最後一次呼叫會被記住用於下一次呼叫 setPara。
註2:呼叫 setContext(null, null) 會取消之前任何非空序章或尾聲設定。 下一次呼叫 setPara() 不會處理序章或尾聲。
注意 3:使用者必須注意,即使在呼叫 setPara() 執行例如邏輯轉換到視覺轉換前已設定上下文,所得字串可能與所有文字(包括序言與結語)同時處理時的字串完全相同。<br> 範例(大寫字母代表 RTL 字元):<br> & nbsp; 序章 = “abc DE”<BR> & NBSP; 後記 = 無<BR> & NBSP; 主文 = “FGH xyz”<BR> & NBSP; paraLevel = LTR<br> 無序言的顯示 = “HGF xyz”(“HGF” 與“xyz” 相鄰)br<> 序言顯示 = “abc HGFED xyz”(“HGF” 與“xyz” 不相鄰)<br>
Java 文件 android.icu.text.Bidi.setContext(java.lang.String, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。