Condividi tramite


Metodo ITextRange::SetText (tom.h)

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

Vedi anche

Informazioni concettuali

Gettext

ITextRange

Riferimento

Modello a oggetti testo

TypeText