IFEDictionary::GetWords メソッド (msime.h)

[アーティクル]
03/13/2024

辞書から単語エントリを取得します。

単語エントリの選択は、の組み合わせによって実行できます。

文字列の末尾にワイルドカードの有無にかかわらず、日本語のふりがなを含む文字列。
末尾にワイルドカードが付いている単語、または末尾にワイルドカードがない単語。
音声の一部

また、ひらがな50音順で範囲を指定することで、日本語のふりがなを持つ文字列による検索を行うことができます。

構文

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
);

パラメーター

[in] pwchFirst

IFEDictionary エントリが一致するテキスト文字列。値は次のいずれかである必要があります。

値	意味
NULL	低い値。
	ひらがな文字列 (取得するフルテキスト)。
	"*" で終わるひらがな文字列 (テキストの先頭文字のみを指定)。これは、単語の範囲を取得する場合に最初のテキスト文字列にすることができます。この場合、ワイルドカードを使用しないでください。

[in] pwchLast

テキスト文字列を終了するために使用されるテキスト文字列。取得が 1 つの値によって実行される場合、IMEWRD 構造体の pwchReading と同じ値を含める必要があります。つまり、範囲の値ではありません。値は、次のいずれかである必要があります。

値	意味
NULL	高い値。
	ひらがな文字列 (取得するフルテキスト)。
	"*" で終わるひらがな文字列 (テキストの先頭文字のみを指定)。

[in] pwchDisplay

IFEDictionary エントリが一致する表示文字列。値は次のいずれかである必要があります。

値	意味
NULL	"*" を意味します。
	任意の日本語文字列。
	"*" で終わる日本語文字列。

[in] ulPos

Microsoft IME Public Parts of Speech でフィルター処理します。これは、次のフラグの 1 つ以上の組み合わせです。

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

単語のクエリ出力を指定します。これは、次のフラグの 1 つ以上の組み合わせです。

IFED_SELECT_NONE

IFED_SELECT_READING

IFED_SELECT_DISPLAY

IFED_SELECT_POS

IFED_SELECT_COMMENT

IFED_SELECT_ALL

[in] ulWordSrc

source という単語を指定します。 IFEDictionary がユーザーディクショナリの場合、これは次のフラグの 1 つ以上の組み合わせです。

IFED_REG_NONE

IFED_REG_USER

IFED_REG_AUTO

IFED_REG_GRAMMAR

IFED_REG_ALL

[in, out] pchBuffer

データを受信するために呼び出し元によって提供されるバッファー。

[in] cbBuffer

pchBuffer のサイズ。

[out] pcWrd

pchBuffer で返される IMEWRD 構造体の数。 pchBuffer が格納できるエントリよりも多くのエントリが見つかった場合は、IFED_S_MORE_ENTRIESが返されます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK
IFED_S_MORE_ENTRIES	クライアントは NextWords を呼び出して、追加の IMEWRD 構造体を取得する必要があります。
IFED_E_NO_ENTRY
E_OUTOFMEMORY
E_FAIL

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	msime.h

こちらもご覧ください

IFEDictionary

IMEWRD

NextWords

次の方法で共有