ITextInputPanel ::SetInPlaceVisibility, 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.

]

Affiche ou masque le panneau d’entrée Tablet PC.

Syntaxe

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

Paramètres

Visible

TRUE pour afficher le panneau d’entrée ; FALSE pour masquer le panneau d’entrée.

Valeur retournée

Si le panneau d’entrée peut s’afficher, la méthode retourne S_OK, sinon E_FAIL. Consultez la section Remarques pour plus d’informations sur les cas où le panneau d’entrée peut et ne peut pas être affecté par la méthode ITextInputPanel ::SetInPlaceVisibility.

Remarques

Le panneau d’entrée s’affiche comme spécifié par la propriété ITextInputPanel ::CurrentInPlaceState .

L’appel de la méthode ITextInputPanel ::SetInPlaceVisibility avec le paramètre Visible défini sur TRUE échoue si le panneau d’entrée est déjà visible.

Si l’utilisateur a désactivé le mode sur place à partir de la boîte de dialogue Options du panneau d’entrée, l’appel de la méthode ITextInputPanel ::SetInPlaceVisibility échoue.

Toute entrée manuscrite déjà présente dans le panneau d’entrée, lorsque la visibilité change, est automatiquement insérée.

Cette méthode ne modifie pas la valeur de la propriété ITextInputPanel ::InPlaceVisibleOnFocus, et lors du changement de focus suivant, le comportement revient au comportement spécifié par la propriété ITextInputPanel ::InPlaceVisibleOnFocus.

La méthode ITextInputPanel ::SetInPlaceVisibility est un appel synchrone. La visibilité du panneau d’entrée change avant le retour de l’appel.

Exemples

Cet exemple C++ implémente un gestionnaire d’événements EN_SETFOCUS pour un contrôle Edit, IDC_EDIT1. Il vérifie d’abord si un objet ITextInputPanel , g_pTip, a été créé. S’il existe, il empêche le panneau d’entrée de s’afficher en appelant la méthode ITextInputPanel ::SetInPlaceVisibility avec la valeur false pour le paramètre Visible .

void CCOMTIPDlg::OnEnSetfocusEdit1()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceVisibility(false)))
		{
			TRACE("Successfully hid the Input Panel.\n");
		}
	}
}

Configuration requise

Voir aussi

ITextInputPanel, interface

ITextInputPanel ::D efaultInPlaceState, propriété

ITextInputPanel ::SetInPlaceHoverTargetPosition, méthode

ITextInputPanel ::SetInPlacePosition, méthode

InPlaceState, énumération