Metodo ITextRange::SetFont (tom.h)

Imposta gli attributi di carattere di questo intervallo su quelli dell'oggetto ITextFont specificato.

Sintassi

HRESULT SetFont(
  [in] ITextFont *pFont
);

Parametri

[in] pFont

Tipo: ITextFont*

Oggetto carattere con il formato di carattere desiderato.

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
Valore	Significato
E_ACCESSDENIED	Il testo è protetto.
E_INVALIDARG	pFont è null.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Per le modifiche di formato occasionali, usare il metodo ITextRange::SetFont . Tuttavia, per apportare una serie di modifiche alla formattazione dei caratteri, è più efficiente usare un duplicato del tipo di carattere. Questo perché ogni volta che si esegue un'istruzione come range.font.bold = tomTrue, un oggetto carattere viene allocato e liberato. Tuttavia, un duplicato del tipo di carattere può essere allocato una volta e usato molte volte. Inoltre, è possibile salvare il duplicato del tipo di carattere, reimpostarlo negli stati predefiniti o non definiti con il metodo Reset e assegnarne i valori in base alle esigenze per l'elaborazione rich-text. Per il codice di esempio che illustra come usare duplicati dei tipi di carattere, vedere Uso di un duplicato del tipo di carattere.

Requisiti

Requisito	Valore
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

ITextRange

Riferimento

Reimpostazione

Modello a oggetti testo