ITextInputPanel：：get_InPlaceVisibleOnFocus 方法 (peninputpanel.h)

[ITextInputPanel 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請改用 IInputPanelConfiguration。

]

取得或設定值，指出當平板電腦輸入面板附加的視窗取得焦點時，是否會自動顯示平板電腦輸入面板。

這是可讀寫的屬性。

語法

HRESULT get_InPlaceVisibleOnFocus(
  BOOL *Visible
);

參數

Visible

傳回值

無

備註

如果 控件的 ITextInputPanel：：InPlaceVisibleOnFocus 屬性 設定為 TRUE ，則當控件取得焦點時，平板電腦輸入面板會自動顯示在預設 的 InPlaceState 列舉 中，前提是它是合法的作業。

將 ITextInputPanel：：InPlaceVisibleOnFocus 屬性 設定為 FALSE，即可防止就地輸入面板和輸入面板圖示出現。 將它設定為TRUE 會將它還原為可能時出現的系統預設值，前提是使用者或 群組原則 尚未停用。 這個選項適用於包含自訂文字輸入解決方案作為輸入面板替代方案的應用程式。

預設值為 TRUE。

範例

這個 C++ 範例會建立 ITextInputPanel 物件，g_pTip並藉由設定 ITextInputPanel：：AttachedEditWindow 屬性，將它附加至 InkEdit 控件IDC_EDIT3的視窗句柄。 它也會設定，然後取得 ITextInputPanel：：InPlaceVisibleOnFocus 屬性。

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

另請參閱

ITextInputPanel 介面