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

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_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-Eigenschaft ist eine Einstellung, da der direkte Eingabebereich die von der Anwendung festgelegte Einstellung überschreibt, wenn dies erforderlich ist, um den Eingabebereich auf dem Bildschirm zu behalten. 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 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 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