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 |
|---|---|
|
Significato |
|
Il testo è protetto. |
|
pFont è null. |
|
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
Riferimento