Metodo ITextStoreAnchor::GetTextExt (textstor.h)

Il metodo ITextStoreAnchor::GetTextExt restituisce il rettangolo di selezione, nelle coordinate dello schermo, di un intervallo di testo. Il chiamante deve avere un blocco di sola lettura nel documento prima di chiamare questo metodo.

Sintassi

HRESULT GetTextExt(
  [in]  TsViewCookie vcView,
  [in]  IAnchor      *paStart,
  [in]  IAnchor      *paEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Parametri

[in] vcView

Specifica la visualizzazione contesto.

[in] paStart

Specifica l'ancoraggio posizionato all'inizio dell'intervallo.

[in] paEnd

Specifica l'ancoraggio posizionato alla fine dell'intervallo.

[out] prc

Riceve il rettangolo di selezione dell'intervallo di testo nelle coordinate dello schermo.

[out] pfClipped

Riceve un valore booleano che specifica se il testo nella casella di selezione è stato ritagliato. Se TRUE, la casella di selezione contiene testo ritagliato e non include l'intero intervallo di testo richiesto. Il rettangolo di selezione viene ritagliato perché l'intervallo richiesto non è visibile.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Il metodo non è riuscito a ottenere un puntatore di interfaccia valido all'avvio e/o agli ancoraggi finali.
TS_E_INVALIDARG	Uno o più parametri di input non sono validi.
TS_E_INVALIDPOS	L'intervallo specificato dai parametri paStart e paEnd si estende oltre l'inizio o la fine del documento.
TS_E_NOLAYOUT	L'applicazione non ha calcolato un layout di testo. Tutte le chiamate aggiuntive non avranno esito positivo finché l'applicazione chiama ITextStoreAnchorSink::OnLayoutChange.
TS_E_NOLOCK	Il chiamante non dispone di un blocco di sola lettura nel documento.

Commenti

Se la finestra del documento viene ridotta al minimo o se il testo specificato non è attualmente visibile, il metodo restituisce S_OK con il parametro prc impostato su {0,0,0,0}.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITextStoreAnchor

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt