Metodo ITextInputPanel::SetInPlaceHoverTargetPosition (peninputpanel.h)

[ITextInputPanel è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece IInputPanelConfiguration.

]

Posiziona in modo esplicito la destinazione del pannello di input del Tablet PC nelle coordinate dello schermo.

Sintassi

HRESULT SetInPlaceHoverTargetPosition(
  int xPosition,
  int yPosition
);

Parametri

xPosition

Coordinata x orizzontale per l'angolo superiore sinistro della destinazione del passaggio del mouse, senza visibile la barra di correzione.

yPosition

Coordinata y verticale per l'angolo superiore sinistro della destinazione del passaggio del mouse, senza visibile la barra di correzione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Non sono previste restrizioni sulla posizione in cui è possibile posizionare la destinazione del passaggio del mouse. L'applicazione è responsabile di assicurarsi che la destinazione del passaggio del mouse rimanga sullo schermo.

Il metodo SetInPlaceHoverTargetPosition è sincrono. Il posizionamento si verifica prima della restituzione del metodo.

Esempio

Questo esempio C++ implementa un EN_SETFOCUS gestore eventi per un controllo Edit, IDC_EDIT2. Verifica innanzitutto se è stato creato un oggetto ITextInputPanel , g_pTip, . Se esiste, imposta la posizione della destinazione al passaggio del mouse del pannello di input chiamando il metodo ITextInputPanel::SetInPlaceHoverTargetPosition. Segnala quindi se la chiamata ha avuto esito positivo per eseguire il debug dell'output usando la macro TRACE .

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");
    }
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	peninputpanel.h
DLL	Tiptsf.dll

Vedi anche

Interfaccia ITextInputPanel

Metodo ITextInputPanel::SetInPlacePosition

Metodo ITextInputPanel::SetInPlaceVisibility