ITextInputPanel ::p ut_InPlaceVisibleOnFocus, méthode (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é obtient le focus.
Cette propriété est en lecture/écriture.
Syntaxe
HRESULT put_InPlaceVisibleOnFocus(
BOOL Visible
);
Paramètres
Visible
Valeur de retour
None
Remarques
Si la propriété ITextInputPanel ::InPlaceVisibleOnFocus est définie sur 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. La définition de la valeur TRUE rétablit la valeur par défaut du système qui s’affiche lorsque cela est possible, à condition qu’elle n’ait pas été désactivée 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 en guise d’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 Property . 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 Tablette 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 |