ITextInputPanel::p ut_PreferredInPlaceDirection 方法 (peninputpanel.h)
[ITextInputPanel 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請改用 IInputPanelConfiguration。
]
取得或設定相對於文字輸入字段的就地輸入面板慣用方向。
這是可讀寫的屬性。
語法
HRESULT put_PreferredInPlaceDirection(
InPlaceDirection Direction
);
參數
Direction
傳回值
無
備註
應用程式可以指定就地輸入面板預設會顯示在文字輸入欄位上方或下方。 若要這樣做,應用程式可以將 ITextInputPanel::P referredInPlaceDirection 屬性 設定為 InPlaceDirection_Bottom 或 InPlaceDirection_Top。 ITextInputPanel::P referredInPlaceDirection 屬性 是喜好設定,因為就地輸入面板會在必要時覆寫應用程式設定的喜好設定,以將輸入面板保留在螢幕上。 系統預設值是盡可能將就地輸入面板置於文字欄位下方,否則將其置於上方。 將 PreferredInPlaceDirection 設定為 InPlaceDirection_Auto 還原系統預設值。
範例
這個 C++ 範例會建立 ITextInputPanel 物件,g_pTip
並藉由設定 ITextInputPanel::AttachedEditWindow 屬性,將它附加至 InkEdit 控件IDC_EDIT3
的視窗句柄。 它也會設定,然後取得 ITextInputPanel::P referredInPlaceDirection 屬性。
if (SUCCEEDED(CoInitialize(NULL)))
{
if (SUCCEEDED(CoCreateInstance(CLSID_TextInputPanel, NULL, CLSCTX_INPROC, IID_ITextInputPanel, (VOID**)&g_pTip)))
{
if (SUCCEEDED(g_pTip->put_AttachedEditWindow(GetDlgItem(IDC_EDIT3)->m_hWnd)))
{
g_pTip->put_DefaultInPlaceState(InPlaceState_Expanded);
InPlaceState ips;
g_pTip->get_DefaultInPlaceState(&ips);
TRACE("DefaultInplaceState: %d\n", ips);
g_pTip->put_DefaultInputArea(PanelInputArea_CharacterPad);
PanelInputArea pia;
g_pTip->get_DefaultInputArea(&pia);
TRACE("DefaultInputArea: %d\n", pia);
g_pTip->put_ExpandPostInsertionCorrection(FALSE);
BOOL epic;
g_pTip->get_ExpandPostInsertionCorrection(&epic);
TRACE("ExpandPostInsertionCorrection: %d\n", epic);
g_pTip->put_InPlaceVisibleOnFocus(TRUE);
BOOL ipvof;
g_pTip->get_InPlaceVisibleOnFocus(&ipvof);
TRACE("InPlaceVisibleOnFocus: %d\n", ipvof);
g_pTip->put_PreferredInPlaceDirection(InPlaceDirection_Top);
InPlaceDirection direction;
g_pTip->get_PreferredInPlaceDirection(&direction);
TRACE("PreferredInPlaceDirection: %d\n", direction);
}
}
else
{
TRACE("Failed to create ITextInputPanel object.\n");
}
}
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | peninputpanel.h |
Dll | Tiptsf.dll |