ITfFnGetPreferredTouchKeyboardLayout::GetLayout-Methode (ctffunc.h)
Ruft den Layoutbezeichner der Bildschirmtastatur des Layouts ab, das der IME die Bildschirmtastatur angibt, während der IME aktiv ist.
Syntax
HRESULT GetLayout(
[out] TKBLayoutType *pTKBLayoutType,
[out] WORD *pwPreferredLayoutId
);
Parameter
[out] pTKBLayoutType
Zeiger auf eine TKBLayoutType-Enumeration , die den Layouttyp empfängt.
[out] pwPreferredLayoutId
Zeiger auf einen WORD-Wert , der den Layoutbezeichner empfängt.
Rückgabewert
Die Bildschirmtastatur erwartet immer S_OK.
Hinweise
TKBLayoutType ist eine Enumeration mit den folgenden Werten.
| TKBLT_UNDEFINED | Nicht definiert. |
| TKBLT_CLASSIC |
Die Bildschirmtastatur soll ein klassisches Layout verwenden.
Klassische Layouts stellen die älteren Layouts physischer Tastaturen dar. |
| TKBLT_OPTIMIZED |
Die Bildschirmtastatur soll ein für die Toucheingabe optimiertes Layout verwenden.
Touchoptimierte Layouts wurden speziell unter Berücksichtigung der Toucheingabe entworfen. |
Die von dieser API zurückgegebenen Layoutbezeichner müssen aus der folgenden Liste stammen. Jeder Bezeichner ist spezifisch für eine bestimmte Sprache, und diese sind alle spezifisch für die Bildschirmtastatur. Es gibt keine Möglichkeit, Unterstützung für andere Layouts anzufordern oder neue, für die Toucheingabe optimierte Layouts dynamisch hinzuzufügen.
| Layoutdefinition | Wert | Unterstützte Eingabesprache |
|---|---|---|
| TKBL_UNDEFINED | 0 | – |
| TKBL_CLASSIC_TRADITIONAL_CHINESE_PHONETIC | 0x0404 | CHT |
| TKBL_CLASSIC_TRADITIONAL_CHINESE_CHANGJIE | 0xF042 | CHT |
| TKBL_CLASSIC_TRADITIONAL_CHINESE_DAYI | 0xF043 | CHT |
| TKBL_OPT_JAPANESE_ABC | 0x0411 | JPN |
| TKBL_OPT_KOREAN_HANGUL_2_BULSIK | 0x0412 | KOR |
| TKBL_OPT_SIMPLIFIED_CHINESE_PINYIN | 0x0804 | CHS |
| TKBL_OPT_TRADITIONAL_CHINESE_PHONETIC | 0x0404 | CHT |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ctffunc.h |