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

Artigo
08/24/2023

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 estruturas IMEWRD 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

Compartilhar via