ITextInputPanel::p ut_InPlaceVisibleOnFocus-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 einen Wert ab, der angibt, ob der Tablet PC-Eingabebereich automatisch angezeigt wird, wenn das Fenster, an das er angefügt ist, den Fokus erhält, oder legt ihn fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_InPlaceVisibleOnFocus(
  BOOL Visible
);

Parameter

Visible

Rückgabewert

Keine

Bemerkungen

Wenn die ITextInputPanel::InPlaceVisibleOnFocus-Eigenschaft für ein Steuerelement auf TRUE festgelegt ist, wird der Eingabebereich des Tablet-PCs automatisch in der Standardmäßigen InPlaceState-Enumeration angezeigt, sofern es sich um einen legalen Vorgang handelt.

Es ist möglich, zu verhindern, dass der direkte Eingabebereich und das Eingabebereichssymbol jemals angezeigt werden, indem die ITextInputPanel::InPlaceVisibleOnFocus-Eigenschaft auf FALSE festgelegt wird. Wenn sie auf TRUE festgelegt wird, wird sie nach Möglichkeit auf den Systemstandard zurückgesetzt, sofern er nicht vom Benutzer oder Gruppenrichtlinie deaktiviert wurde. Diese Option ist nützlich für Anwendungen, die benutzerdefinierte Texteingabelösungen als Alternative zum Eingabebereich enthalten.

Der Standardwert ist TRUE.

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::InPlaceVisibleOnFocus-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