Metodo ITextInputPanel::p ut_PreferredInPlaceDirection (peninputpanel.h)

Articolo
03/01/2024

[ITextInputPanel è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece IInputPanelConfiguration.

]

Ottiene o imposta la direzione preferita del pannello di input sul posto rispetto al campo voce di testo.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_PreferredInPlaceDirection(
  InPlaceDirection Direction
);

Parametri

Direction

Valore restituito

nessuno

Osservazioni

Un'applicazione può specificare se i valori predefiniti del pannello di input sul posto vengono visualizzati sopra o sotto un campo di voce di testo. A tale scopo, l'applicazione può impostare la proprietà ITextInputPanel::P referredInPlaceDirection su InPlaceDirection_Bottom o InPlaceDirection_Top. ITextInputPanel::P referredInPlaceDirection Property è una preferenza perché il pannello di input sul posto sostituisce la preferenza impostata dall'applicazione quando necessario per mantenere il pannello di input sullo schermo. Il valore predefinito del sistema consiste nel posizionare il pannello di input sul posto sotto un campo di testo quando possibile e in caso contrario per posizionarlo sopra. L'impostazione di PreferredInPlaceDirection su InPlaceDirection_Auto ripristina l'impostazione predefinita del sistema.

Esempio

Questo esempio C++ crea un oggetto ITextInputPanel, g_pTipe lo collega all'handle della finestra di un controllo InkEdit, , IDC_EDIT3impostando la proprietà ITextInputPanel::AttachedEditWindow. Imposta anche la proprietà ITextInputPanel::P referredInPlaceDirection.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	peninputpanel.h
DLL	Tiptsf.dll

Vedi anche

Interfaccia ITextInputPanel

Condividi tramite