ITextInputPanel::get_DefaultInPlaceState-Methode (peninputpanel.h)

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

]

Ruft den in der InPlaceState-Enumeration angegebenen Standardzustand ab oder legt diese fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_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 Hoverziel tippen muss. Wenn Sie den Standardzustand auf InPlaceState_HoverTarget festlegen, wird die Heuristik des Eingabebereichs für die verbleibenden erweiterten Elemente außer Kraft gesetzt. Wenn Sie zwischen Feldern wechseln, erzwingt das Festlegen der Standardeinstellung, dass der Eingabebereich nach einer Fokusänderung den reduzierten oder darauf zeigenden Zustand aufweist. Der Standard des Systems ist InPlaceState_Auto.

Beispiele

In diesem C++-Beispiel wird ein ITextInputPanel-Objekt erstellt g_pTipund an 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