immGetProperty 函式 (imm.h)
擷取與指定輸入地區設定相關聯的 IME 屬性和功能。
語法
DWORD ImmGetProperty(
HKL unnamedParam1,
DWORD unnamedParam2
);
參數
unnamedParam1
unnamedParam2
傳回值
根據 dwIndex 參數的值，傳回 屬性或功能值。 如果 dwIndex 設定為 IGP_PROPERTY，函式會傳回下列一或多個值：
| 值 | 意義 |
|---|---|
| IME_PROP_AT_CARET | 如果設定，轉換視窗位於插入號位置。 如果清除，則視窗接近插入號位置。 |
| IME_PROP_SPECIAL_UI | 如果設定，則輸入法具有非標準使用者介面。 應用程式不應該在輸入法視窗中繪製。 |
| IME_PROP_CANDLIST_START_FROM_1 | 如果設定，候選清單中的字串會從 1 開始編號。 如果清除，字串會從 0 開始。 |
| IME_PROP_UNICODE | 如果設定，則會將 IME 視為 Unicode IME。 操作系統和 IME 會透過 Unicode IME 介面進行通訊。 如果清楚，IME 會使用 ANSI 介面與作業系統通訊。 |
| IME_PROP_COMPLETE_ON_UNSELECT | 如果設定，IME 會在停用 IME 時完成組合字串。 如果清除，IME 會在停用 IME 時取消組合字串，例如，從鍵盤配置變更。 |
| IME_PROP_ACCEPT_WIDE_VKEY | 如果設定，IME 會使用 VK_PACKET 來處理來自 SendInput 函式的插入 Unicode。 如果清楚，輸入法可能不會處理插入的 Unicode，而且可能會將插入的 Unicode 直接傳送至應用程式。 |
如果 dwIndex 設定為 IGP_UI，函式會傳回下列一或多個值：
| 值 | 意義 |
|---|---|
| UI_CAP_2700 | 支援 0 或 2700 的文字逸出值。 如需詳細資訊，請參閱LOGFONT結構的 lfEscapement成員。 |
| UI_CAP_ROT90 | 支援 0、900、1800 或 2700 的文字逸出值。 如需詳細資訊，請參閱 lfEscapement。 |
| UI_CAP_ROTANY | 支援任何文字逸出值。 如需詳細資訊，請參閱 lfEscapement。 |
如果 dwIndex 設定為 IGP_SETCOMPSTR，函式會傳回下列一或多個值：
| 值 | 意義 |
|---|---|
| SCS_CAP_COMPSTR | 使用 SCS_SETSTR 值呼叫 ImmSetCompositionString 函式，以建立組合字串。 |
| SCS_CAP_MAKEREAD | 使用 ImmSetCompositionString 函式搭配 SCS_SETSTR，而不設定 lpRead 時，從對應的撰寫字串建立讀取字串。 |
| SCS_CAP_SETRECONVERTSTRING： | 此輸入法可以支援重新復原。 使用 ImmSetCompositionString 來執行重新轉換。 |
如果 dwIndex 設定為 IGP_SELECT，函式會傳回下列一或多個值：
| 值 | 意義 |
|---|---|
| SELECT_CAP_CONVMODE | 選取新的輸入法時，繼承轉換模式。 |
| SELECT_CAP_SENTENCE | 選取新的輸入法時，繼承句子模式。 |
如果 dwIndex 設定為 IGP_GETIMEVERSION，函式會傳回下列一或多個值：
| 值 | 意義 |
|---|---|
| IMEVER_0310 | IME 是針對 Windows 3.1 所建立。 |
| IMEVER_0400 | IME 是針對 Windows Me/98/95 所建立。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。 |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | imm.h (包括 Immdev.h、Windows.h) |
| 程式庫 | Imm32.lib |
| Dll | Imm32.dll |