Editor_Convert¶

轉換字元。您能直接用該內嵌函式或明確地發送 EE_CONVERT 或 EE_CONVERT_EX 消息。

Editor_Convert( HWND hwnd, UINT nFlags, LPCWSTR szChars = NULL, LPCWSTR pszSeparator = NULL, UINT nSortFlags = 0, LPCWSTR pszLocale = NULL );

參數¶

hwnd

指定 EmEditor 視圖或框架的視窗控制代碼。

nFlags

您能從如下值中指定一個組合。


值	含義
FLAG_MAKE_LOWER	轉換為小寫字元。
FLAG_MAKE_UPPER	轉換為大寫字元。
FLAG_HAN_TO_ZEN	轉換為全形字元。
FLAG_ZEN_TO_HAN	轉換為半形字元。
FLAG_CAPITALIZE	大寫每一個單字的第一個字母。
FLAG_MAKE_LOWER_L	轉換為小寫字元（與地區設定相關）。
FLAG_MAKE_UPPER_L	轉換為大寫字元（與地區設定相關）。
FLAG_CAPITALIZE_L	將每個單字的首字母大寫（與地區設定相關）。
FLAG_CONVERT_SELECT_ALL	轉換整個文字。如果沒有設置該標志，EE_CONVERT 只會轉換選取部分的字元。
FLAG_CONVERT_KATA	轉換片假名。
FLAG_CONVERT_ALPHANUMERIC	轉換字母和數字字元。
FLAG_CONVERT_MARK	轉換標記。
FLAG_CONVERT_SPACE	轉換空白。
FLAG_CONVERT_KANA_MARK	轉換假名標記。
FLAG_CONVERT_CUSTOM	當指定 FLAG_HAN_TO_ZEN 或 FLAG_ZEN_TO_HAN 時，szChars 參數指定應轉換哪些單個字元。如果指定了此值，則還必須指定 szChars 參數，並忽略 FLAG_CONVERT_KATA，FLAG_CONVERT_ALPHANUMERIC，FLAG_CONVERT_MARK，FLAG_CONVERT_SPACE，FLAG_CONVERT_KANA_MARK 的值。
FLAG_JAPANESE_YEN	將 U+005C（反斜線）轉換為 U+FFE5（全形日幣標記），反之亦然。
FLAG_KOREAN_WON	將 U+005C（反斜線）轉換為 U+FFE6（全形韓幣標記），反之亦然。
FLAG_RIGHT_SINGLE_QUOTATION	將 U+0027（縮寫符號）轉換為 U+2019（右單引號），反之亦然。
FLAG_RIGHT_DOUBLE_QUOTATION	將 U+0022（引號）轉換為 U+201D（右雙引號），反之亦然。

szChars

如果指定了 FLAG_CONVERT_CUSTOM，則可以設定要轉換的單個全形字元的組合。如果不使用，請將此參數設定為 NULL。

pszSeparator

指定一個字串作為分割欄時的分隔符號。

nSortFlags

你可以指定以下值的組合。必須指定 SORT_ENABLED 以對分割字串進行排序，可以與其他旗標合用來指定排序行為。必須指定 SORT_DELETE_DUPLICATE 以刪除重複的分割字串。

值	含義
NORM_IGNORECASE	忽略大小寫。
NORM_IGNOREKANATYPE	平假名和片假名字元相等。
NORM_IGNORENONSPACE	忽略非空格字元。
NORM_IGNORESYMBOLS	忽略符號。
NORM_IGNOREWIDTH	忽略半形和全形字元之間的差別。
SORT_BINARY_COMPARISON	用快速二進位比較來排序。將忽略區域設定信息。
SORT_DATE	對日期和時間進行排序。
SORT_DELETE_DUPLICATE	刪除重複的分割字串。
SORT_DIGITSASNUMBERS	即使按字母順序排序，數字也會作為序號被排序。
SORT_ENABLED	排序分割字串。
SORT_IGNORE_PREFIX	當用數字升序或數字降序命令時，排序時開頭非數字字元會被忽略。
SORT_IPV4	對 IPv4 地址進行排序。
SORT_IPV6	對 IPv6 地址進行排序。
SORT_LENGTH	按字元數對字串排序。
SORT_LENGTH_VIEW	當選擇按文字長度排序命令時，全形字元會被視為 2 個字元。
SORT_NUM	對數字進行排序。
SORT_GROUP_IDENTICAL	按出現次數對相同的字串進行群組。必須與 SORT_OCCURRENCE 一起指定。
SORT_OCCURRENCE	按出現次數排序。
SORT_RANDOM	隨機排序。
SORT_REVERSE	反向排序。
SORT_STABLE	使用平穩排序。平穩排序維護記錄的相對順序，但通常較慢。
SORT_STRINGSORT	把標點符號視為符號。
SORT_TEXT	對文字進行排序。
SORT_WORDS	按字數對字串排序。
SPLIT_DONT_DISCARD_EXTRA	當 nLimit 不為 0 時，不丟棄多余的分割字串。

pszLocale

指定排序的地區設定資訊。如果該值為空，將使用在自訂對話方塊中「排序」頁面上指定的地區設定資訊。

如果消息成功，返回值為非零值。如果該消息不成功，返回值為零。

支持 EmEditor Professional 22.1 或之後的版本。