ITextInputPanel::SetInPlaceHoverTargetPosition-Methode (peninputpanel.h)
[ITextInputPanel ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen IInputPanelConfiguration.
]
Positioniert den Tablet PC-Eingabebereich explizit mit dem Mauszeigerziel in Bildschirmkoordinaten.
Syntax
HRESULT SetInPlaceHoverTargetPosition(
int xPosition,
int yPosition
);
Parameter
xPosition
Die horizontale x-Koordinate für die obere linke Ecke des Mausziels, ohne dass ein Korrekturkamm sichtbar ist.
yPosition
Die vertikale y-Koordinate für die obere linke Ecke des Mausziels, ohne dass ein Korrekturkamm sichtbar ist.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Es ist ein unbekannter Fehler aufgetreten. |
Hinweise
Es gibt keine Einschränkungen, wo das Hoverziel platziert werden kann. Die Anwendung ist dafür verantwortlich, dass das Ziel mit dem Mauszeiger auf dem Bildschirm bleibt.
Die SetInPlaceHoverTargetPosition-Methode ist synchron. Die Positionierung erfolgt, bevor die Methode zurückgibt.
Beispiele
In diesem C++-Beispiel wird ein EN_SETFOCUS Ereignishandler für ein Edit-Steuerelement implementiert. IDC_EDIT2 Zuerst wird überprüft, ob ein ITextInputPanel-Objekt erstellt g_pTipwurde. Falls vorhanden, wird die Position des Ziels des Eingabebereichs mit dem Mauszeiger festgelegt, indem die ITextInputPanel::SetInPlaceHoverTargetPosition-Methode aufgerufen wird. Anschließend wird gemeldet, ob der Aufruf erfolgreich war, um die Ausgabe mithilfe des TRACE-Makros zu debuggen.
void CCOMTIPDlg::OnEnSetfocusEdit2()
{
if (NULL != g_pTip)
{
if (SUCCEEDED(g_pTip->SetInPlaceHoverTargetPosition(300, 300)))
{
TRACE("Call to SetInPlaceHoverTargetPosition() succeeded.\n");
}
else
{
TRACE("Call to SetInPlaceHoverTargetPosition() failed.\n");
}
}
else
{
TRACE("ITextInputPanel object is NULL.\n");
}
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | peninputpanel.h |
| DLL | Tiptsf.dll |