Compartilhar via


Método ITfFnGetPreferredTouchKeyboardLayout::GetLayout (ctffunc.h)

Obtém o identificador de layout do teclado virtual do layout que o IME direciona o teclado virtual para mostrar enquanto o IME está ativo.

Sintaxe

HRESULT GetLayout(
  [out] TKBLayoutType *pTKBLayoutType,
  [out] WORD          *pwPreferredLayoutId
);

Parâmetros

[out] pTKBLayoutType

Ponteiro para uma enumeração TKBLayoutType que recebe o tipo de layout.

[out] pwPreferredLayoutId

Ponteiro para um valor WORD que recebe o identificador de layout.

Retornar valor

O teclado virtual sempre espera S_OK.

Comentários

TKBLayoutType é uma enumeração com os valores a seguir.

TKBLT_UNDEFINED Indefinido.
TKBLT_CLASSIC O teclado virtual é usar um layout clássico.

Os layouts clássicos representam os layouts herdados dos teclados físicos.

TKBLT_OPTIMIZED O teclado virtual é usar um layout com otimização de toque.

Os layouts com otimização de toque foram projetados especificamente com o toque em mente.

 

Os identificadores de layout retornados por essa API devem ser um da lista a seguir. Cada identificador é específico para um determinado idioma e todos eles são específicos para o teclado virtual. Não há como solicitar suporte para outros layouts ou adicionar novos layouts otimizados por toque dinamicamente.

Definição de layout Valor Idioma de entrada com suporte
TKBL_UNDEFINED 0 n/d
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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ctffunc.h

Confira também

ITfFnGetPreferredTouchKeyboardLayout