Metodo ITextInputPanel::p ut_InPlaceVisibleOnFocus (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 un valore che indica se il pannello di input del TABLET PC viene visualizzato automaticamente quando la finestra a cui è collegata ottiene lo stato attivo.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_InPlaceVisibleOnFocus(
  BOOL Visible
);

Parametri

Visible

Valore restituito

nessuno

Osservazioni

Se la proprietà ITextInputPanel::InPlaceVisibleOnFocus è impostata su TRUE per un controllo, quando il controllo ottiene lo stato attivo, il pannello di input del TABLET PC viene visualizzato automaticamente nell'enumerazione InPlaceState predefinita purché sia un'operazione legale.

È possibile impedire la visualizzazione del pannello di input sul posto e dell'icona del pannello di input impostando la proprietà ITextInputPanel::InPlaceVisibleOnFocus su FALSE. Impostandola su TRUE, viene ripristinata l'impostazione predefinita del sistema quando possibile, purché non sia stata disabilitata dall'utente o dal Criteri di gruppo. Questa opzione è utile per le applicazioni che includono soluzioni di immissione di testo personalizzate come alternativa al pannello di input.

Il valore predefinito è TRUE.

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 la proprietà ITextInputPanel::InPlaceVisibleOnFocus.

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