Metodo ITextInputPanel::get_PreferredInPlaceDirection (peninputpanel.h)

[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 di immissione del testo.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_PreferredInPlaceDirection(
  InPlaceDirection *Direction
);

Parametri

Direction

Valore restituito

nessuno

Osservazioni

Un'applicazione può specificare se l'impostazione predefinita del pannello di input sul posto viene visualizzata sopra o sotto un campo di immissione di testo. A tale scopo, l'applicazione può impostare la proprietà ITextInputPanel::P referredInPlaceDirection su InPlaceDirection_Bottom o InPlaceDirection_Top. La proprietà ITextInputPanel::P referredInPlaceDirection è 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. L'impostazione predefinita 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 PreferredInPlaceDirectionsu InPlaceDirection_Auto ripristina l'impostazione predefinita del sistema.

Esempio

In questo esempio di C++ viene creato un oggetto ITextInputPanel, g_pTipe lo associa all'handle della finestra di un controllo InkEdit, IDC_EDIT3, impostando la proprietà ITextInputPanel::AttachedEditWindow. Imposta anche , quindi ottiene 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

Vedi anche

Interfaccia ITextInputPanel