Metodo ITextRange::SetText (tom.h)

Articolo
08/26/2023

Imposta il testo in questo intervallo.

Sintassi

HRESULT SetText(
  [in] BSTR bstr
);

Parametri

[in] bstr

Tipo: BSTR

Testo che sostituisce il testo corrente in questo intervallo. Se null, il testo corrente viene eliminato.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT . Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_ACCESSDENIED	Il testo è protetto da scrittura.
E_INVALIDARG	bstr è Null.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

ITextRange::SetText sostituisce il testo nell'intervallo con il nuovo testo. Al contrario, TypeText sostituisce la selezione con il testo bstr e lascia la selezione come punto di inserimento semplicemente seguendo il testo inserito, come se fosse stato digitato il testo in. Per il comportamento di selezione dell'interfaccia utente, vedere TypeText.

Se, dopo aver chiamato ITextRange::SetText, si chiama ITextRange::GetText, viene restituito lo stesso testo impostato con il metodo ITextRange::SetText (a meno che non sia stato modificato un altro intervallo tra le chiamate).

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll