Metodo ITfContextOwner::GetTextExt (msctf.h)

Articolo
03/05/2024

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

Sintassi

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

Parametri

[in] acpStart

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

[in] acpEnd

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

[out] prc

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

[out] pfClipped

Riceve il valore booleano che specifica se il testo nel rettangolo 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 a causa dell'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 dei caratteri di inizio e fine specificate sono uguali.
TS_E_INVALIDPOS	L'intervallo specificato dai parametri acpStart e acpEnd si estende oltre la fine del documento o la parte superiore 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 sul documento.

Commenti

Se la finestra del documento è ridotta a icona 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	msctf.h
DLL	Msimtf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITextStoreACP::GetTextExt

ITfContextOwner

ITfContextView::GetTextExt

Condividi tramite