ITextInputPanel::p ut_DefaultInPlaceState-Methode (peninputpanel.h)

[ITextInputPanel ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen IInputPanelConfiguration.

]

Ruft den von der InPlaceState-Enumeration angegebenen Standardstatus ab oder legt diese fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_DefaultInPlaceState(
  InPlaceState State
);

Parameter

State

Rückgabewert

Keine

Bemerkungen

Legen Sie diese Eigenschaft auf InPlaceState_Expanded fest, damit der Eingabebereich geöffnet wird, ohne dass der Benutzer auf das Ziel mit dem Mauszeiger tippen muss. Wenn Sie den Standardzustand auf InPlaceState_HoverTarget festlegen, werden die Heuristiken des Eingabebereichs für die verbleibende Erweiterung außer Kraft gesetzt. Wenn Sie zwischen Feldern wechseln, erzwingt das Festlegen der Standardeinstellung den Eingabebereich nach einer Fokusänderung auf den reduzierten oder mit dem Mauszeiger. Der Systemstandard ist InPlaceState_Auto.

Beispiele

In diesem C++-Beispiel wird ein ITextInputPanel-Objekt erstellt und g_pTipan das Fensterhandle eines InkEdit-Steuerelements angefügt, IDC_EDIT3indem die Eigenschaft ITextInputPanel::AttachedEditWindow festgelegt wird. Außerdem wird festgelegt und dann die Eigenschaft ITextInputPanel::D efaultInPlaceState abgerufen.

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

Anforderungen

Weitere Informationen

ITextInputPanel-Schnittstelle