ITextInputPanel::get_PreferredInPlaceDirection-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 die bevorzugte Richtung des direkten Eingabebereichs relativ zum Texteingabefeld ab oder legt diese fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_PreferredInPlaceDirection(
  InPlaceDirection *Direction
);

Parameter

Direction

Rückgabewert

Keine

Bemerkungen

Eine Anwendung kann angeben, ob der direkte Eingabebereich standardmäßig oberhalb oder unterhalb eines Texteingabefelds angezeigt wird. Hierzu kann die Anwendung die ITextInputPanel::P referredInPlaceDirection-Eigenschaft auf InPlaceDirection_Bottom oder InPlaceDirection_Top festlegen. ITextInputPanel::P referredInPlaceDirection Property ist eine Einstellung, da der direkte Eingabebereich die von der Anwendung festgelegte Einstellung außer Kraft setzt, um den Eingabebereich auf dem Bildschirm beizubehalten. Standardmäßig wird der direkte Eingabebereich nach Möglichkeit unter einem Textfeld positioniert und andernfalls darüber positioniert. Durch Festlegen von PreferredInPlaceDirection auf InPlaceDirection_Auto wird der Systemstandard wiederhergestellt.

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 ITextInputPanel::P referredInPlaceDirection-Eigenschaft 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