Metodo ITextStoreACP::GetTextExt (textstor.h)

Articolo
03/02/2024

Il metodo ITextStoreACP::GetTextExt restituisce il rettangolo di selezione, nelle coordinate dello schermo, del testo in una posizione di carattere specificata. Il chiamante deve avere un blocco di sola lettura nel documento prima di chiamare questo metodo.

Sintassi

HRESULT GetTextExt(
  [in]  TsViewCookie vcView,
  [in]  LONG         acpStart,
  [in]  LONG         acpEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Parametri

[in] vcView

Specifica la visualizzazione contesto.

[in] acpStart

Specifica la posizione iniziale del carattere del testo da ottenere nel documento.

[in] acpEnd

Specifica la posizione finale del carattere del testo da ottenere nel documento.

[out] prc

Riceve il rettangolo di selezione nelle coordinate dello schermo del testo in corrispondenza delle posizioni di carattere specificate.

[out] pfClipped

Riceve un valore booleano che specifica se il testo nella casella di selezione è stato ritagliato. Se questo parametro è TRUE, il rettangolo 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.
TS_E_INVALIDARG	Le posizioni di carattere iniziale e finale specificate sono uguali.
TS_E_INVALIDPOS	L'intervallo specificato dai parametri acpStart e acpEnd si estende oltre l'inizio o la fine del documento.
TS_E_NOLAYOUT	L'applicazione non ha calcolato un layout di testo.
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 [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITextStoreACP

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt

Condividi tramite