Méthode ITextInputPanel ::get_InPlaceBoundingRectangle (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 le rectangle englobant pour le panneau d’entrée tablet PC.
Cette propriété est en lecture seule.
Syntaxe
HRESULT get_InPlaceBoundingRectangle(
RECT *BoundingRectangle
);
Paramètres
BoundingRectangle
Valeur de retour
None
Remarques
Si le pavé d’écriture ou le pavé de caractères est actif, la hauteur du bouton Insérer est incluse dans le rectangle englobant du panneau d’entrée sur place. Le rectangle englobant n’inclut pas la hauteur du peigne de correction. Lorsque le panneau d’entrée sur place augmente automatiquement, la paire d’événements ITextInputPanelEventSink ::InPlaceSizeChanging, méthode/ITextInputPanelEventSink ::InPlaceSizeChanged, méthode , est déclenchée et la valeur de cette propriété est mise à jour pour inclure la zone d’écriture ou la ligne d’écriture supplémentaire.
Exemples
Cet exemple C++ implémente un gestionnaire d’événements EN_SETFOCUS
pour un contrôle Edit, IDC_EDIT3
. Il vérifie d’abord si un objet ITextInputPanel , g_pTip
, a été créé. S’il existe, il signale les valeurs de plusieurs propriétés de l’interface ITextInputPanel pour déboguer la sortie à l’aide de la macro TRACE .
void CCOMTIPDlg::OnEnSetFocusEdit3()
{
if (NULL != g_pTip)
{
CorrectionMode mode;
if (SUCCEEDED(g_pTip->get_CurrentCorrectionMode(&mode)))
{
TRACE("CurrentCorrectionMode: %d\n", mode);
}
InPlaceState state;
if (SUCCEEDED(g_pTip->get_CurrentInPlaceState(&state)))
{
TRACE("CurrentInPlaceState: %d\n", state);
}
PanelInputArea area;
if (SUCCEEDED(g_pTip->get_CurrentInputArea(&area)))
{
TRACE("CurrentInputArea: %d\n", area);
}
InteractionMode iMode;
if (SUCCEEDED(g_pTip->get_CurrentInteractionMode(&iMode)))
{
TRACE("CurrentInteractionMode: %d\n", iMode);
}
RECT rect;
if (SUCCEEDED(g_pTip->get_InPlaceBoundingRectangle(&rect)))
{
TRACE("InPlaceBoundingRectangle.top: %d\n", rect.top);
TRACE("InPlaceBoundingRectangle.left: %d\n", rect.left);
TRACE("InPlaceBoundingRectangle.bottom: %d\n", rect.bottom);
TRACE("InPlaceBoundingRectangle.right: %d\n", rect.right);
}
int nHeight;
if (SUCCEEDED(g_pTip->get_PopDownCorrectionHeight(&nHeight)))
{
TRACE("PopDownCorrectionHeight: %d\n", nHeight);
}
if (SUCCEEDED(g_pTip->get_PopUpCorrectionHeight(&nHeight)))
{
TRACE("PopUpCorrectionHeight: %d\n", nHeight);
}
if (SUCCEEDED(g_pTip->SetInPlacePosition(300, 300, CorrectionPosition_Bottom)))
{
TRACE("Call to SetInPlacePosition() succeeded.\n");
}
else
{
TRACE("Call to SetInPlacePosition() failed.\n");
}
}
else
{
TRACE("ITextInputPanel object is NULL.\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 |