Método IFEDictionary::GetWords (msime.h)

Obtém entradas de palavras de um dicionário.

A seleção de uma entrada de palavra pode ser executada por uma combinação de

• Uma cadeia de caracteres com caracteres fonéticos japoneses, com ou sem um curinga no final da cadeia de caracteres.
• Uma palavra, com ou sem um curinga no final.
• Uma parte da fala

Além disso, as recuperações por uma cadeia de caracteres com caracteres fonéticos japoneses podem ser executadas especificando um intervalo na ordenação Hiragana 50-on.

Sintaxe

HRESULT GetWords(
  [in]      const WCHAR *pwchFirst,
  [in]      const WCHAR *pwchLast,
  [in]      const WCHAR *pwchDisplay,
  [in]      ULONG       ulPos,
  [in]      ULONG       ulSelect,
  [in]      ULONG       ulWordSrc,
  [in, out] UCHAR       *pchBuffer,
  [in]      ULONG       cbBuffer,
  [out]     ULONG       *pcWrd
);

Parâmetros

[in] pwchFirst

Uma cadeia de caracteres de texto com a qual as entradas IFEDictionary são correspondidas; o valor deve ser um dos seguintes:

Valor	Significado
NULL	De baixo valor.
	Cadeia de caracteres hiragana (texto completo a ser recuperado).
	Cadeia de caracteres hiragana terminando em "*" (especificando apenas caracteres à esquerda do texto). Isso pode ser uma cadeia de caracteres de texto inicial quando um intervalo de palavras deve ser recuperado; nesse caso, um curinga não deve ser usado.

[in] pwchLast

Uma cadeia de caracteres de texto usada para encerrar uma cadeia de caracteres de texto. Isso deve conter o mesmo valor que pwchReading na estrutura IMEWRD quando uma recuperação é executada por um único valor; ou seja, não por um valor de intervalo. O valor deve ser um dos seguintes:

Valor	Significado
NULL	Valor alto.
	Cadeia de caracteres hiragana (texto completo a ser recuperado).
	Cadeia de caracteres hiragana terminando em "*" (especificando apenas caracteres à esquerda do texto).

[in] pwchDisplay

Uma cadeia de caracteres de exibição na qual as entradas IFEDictionary são correspondidas; o valor deve ser um dos seguintes:

Valor	Significado
NULL	Significa "*".
	Qualquer cadeia de caracteres japonesa.
	Cadeia de caracteres japonesa terminando em "*".

[in] ulPos

Filtro(s) nas Partes de Fala públicas do IME da Microsoft. Essa é uma combinação de um ou mais dos seguintes sinalizadores:

IFED_POS_NONE

IFED_POS_NOUN

IFED_POS_VERB

IFED_POS_ADJECTIVE

IFED_POS_ADJECTIVE_VERB

IFED_POS_ADVERB

IFED_POS_ADNOUN

IFED_POS_CONJUNCTION

IFED_POS_INTERJECTION

IFED_POS_INDEPENDENT

IFED_POS_INFLECTIONALSUFFIX

IFED_POS_PREFIX

IFED_POS_SUFFIX

IFED_POS_AFFIX

IFED_POS_TANKANJI

IFED_POS_IDIOMS

IFED_POS_SYMBOLS

IFED_POS_PARTICLE

IFED_POS_AUXILIARY_VERB

IFED_POS_SUB_VERB

IFED_POS_DEPENDENT

IFED_POS_ALL

[in] ulSelect

Especifica a saída da consulta de uma palavra. Essa é uma combinação de um ou mais dos seguintes sinalizadores:

IFED_SELECT_NONE

IFED_SELECT_READING

IFED_SELECT_DISPLAY

IFED_SELECT_POS

IFED_SELECT_COMMENT

IFED_SELECT_ALL

[in] ulWordSrc

Especifica a palavra origem. Quando o IFEDictionary é um dicionário de usuário, essa é uma combinação de um ou mais dos seguintes sinalizadores:

IFED_REG_NONE

IFED_REG_USER

IFED_REG_AUTO

IFED_REG_GRAMMAR

IFED_REG_ALL

[in, out] pchBuffer

Buffer fornecido pelo chamador para receber os dados.

[in] cbBuffer

O tamanho do pchBuffer.

[out] pcWrd

O número de estruturas IMEWRD retornadas no pchBuffer. Se mais entradas forem encontradas do que pchBuffer pode armazenar, IFED_S_MORE_ENTRIES será retornado.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK
IFED_S_MORE_ENTRIES	O cliente deve chamar NextWords para obter estruturasIMEWRD adicionais.
IFED_E_NO_ENTRY
E_OUTOFMEMORY
E_FAIL

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	msime.h

Confira também

IFEDictionary

IMEWRD

NextWords