Condividi tramite


Metodo ITfContextOwner::GetTextExt (msctf.h)

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