Partager via


Méthode ITextInputPanel ::get_InPlaceVisibleOnFocus (peninputpanel.h)

[ITextInputPanel est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt IInputPanelConfiguration.

]

Obtient ou définit une valeur qui indique si le panneau d’entrée Tablet PC s’affiche automatiquement lorsque la fenêtre à laquelle il est attaché est mise au point.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_InPlaceVisibleOnFocus(
  BOOL *Visible
);

Paramètres

Visible

Valeur de retour

None

Remarques

Si la propriété ITextInputPanel ::InPlaceVisibleOnFocus a la valeur TRUE pour un contrôle, lorsque le contrôle obtient le focus, le panneau d’entrée Tablet PC s’affiche automatiquement dans l’énumération InPlaceState par défaut, à condition qu’il s’agit d’une opération légale.

Il est possible d’empêcher le panneau d’entrée sur place et l’icône du panneau d’entrée d’apparaître en définissant la propriété ITextInputPanel ::InPlaceVisibleOnFocus surFALSE. Le fait de le définir sur TRUE rétablit la valeur par défaut du système, à condition qu’il n’ait pas été désactivé par l’utilisateur ou stratégie de groupe. Cette option est utile pour les applications qui incluent des solutions de saisie de texte personnalisées comme alternative au panneau d’entrée.

La valeur par défaut est TRUE.

Exemples

Cet exemple C++ crée un objet ITextInputPanel , g_pTipet l’attache au handle de fenêtre d’un contrôle InkEdit , IDC_EDIT3, en définissant la propriété ITextInputPanel ::AttachedEditWindow . Il définit également, puis obtient la propriété 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");
    }
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête peninputpanel.h
DLL Tiptsf.dll

Voir aussi

ITextInputPanel, interface