EM_SETCHARFORMAT messaggio

Imposta la formattazione dei caratteri in un controllo di modifica avanzato.

Parametri

wParam

Formattazione dei caratteri che si applica al controllo. Se questo parametro è zero, viene impostato il formato di carattere predefinito. In caso contrario, può essere uno dei valori seguenti.

Valore	Significato
SCF_ALL	Applica la formattazione a tutto il testo del controllo. Non valido con SCF_SELECTION o SCF_WORD.
SCF_ASSOCIATEFONT	RichEdit 4.1: Associa un tipo di carattere a uno script specifico, modificando così il tipo di carattere predefinito per tale script. Per specificare il tipo di carattere, usare i membri seguenti di CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName e lcid.
SCF_ASSOCIATEFONT2	RichEdit 4.1: Associa un carattere surrogato (piano 2) a un determinato script, modificando così il carattere predefinito per tale script. Per specificare il tipo di carattere, usare i membri seguenti di CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName e lcid.
SCF_CHARREPFROMLCID	Ottiene il repertorio di caratteri dall'LCID.
SCF_DEFAULT	RichEdit 4.1: Imposta il tipo di carattere predefinito per il controllo.
SPF_DONTSETDEFAULT	Impedisce di impostare il formato predefinito del paragrafo quando il controllo di modifica avanzato è vuoto.
SCF_NOKBUPDATE	RichEdit 4.1: Impedisce l'opzione della tastiera in modo che corrisponda al tipo di carattere. Ad esempio, se viene impostato un tipo di carattere arabo, in genere la funzionalità della tastiera automatica per le lingue Bidi cambia la tastiera in una tastiera araba.
SCF_SELECTION	Applica la formattazione alla selezione corrente. Se la selezione è vuota, la formattazione dei caratteri viene applicata al punto di inserimento e il nuovo formato di caratteri è effettivo solo finché il punto di inserimento non viene modificato.
SPF_SETDEFAULT	Imposta gli attributi di formattazione del paragrafo predefiniti.
SCF_SMARTFONT	Applicare il tipo di carattere solo se può gestire lo script.
SCF_USEUIRULES	RichEdit 4.1: Usato con SCF_SELECTION. Indica che il formato proviene da una barra degli strumenti o da un altro strumento dell'interfaccia utente, pertanto le regole di formattazione dell'interfaccia utente devono essere usate anziché la formattazione letterale.
SCF_WORD	Applica la formattazione alla parola o alle parole selezionate. Se la selezione è vuota, ma il punto di inserimento si trova all'interno di una parola, la formattazione viene applicata alla parola. Il valore SCF_WORD deve essere usato insieme al valore SCF_SELECTION .

lParam

Puntatore a una struttura CHARFORMAT che specifica la formattazione dei caratteri da usare. Vengono modificati solo gli attributi di formattazione specificati dal membro dwMask .

Microsoft Rich Edit 2.0 e versioni successive: questo parametro può essere un puntatore a una struttura CHARFORMAT2 , ovvero un'estensione della struttura CHARFORMAT . Prima di inviare il messaggio EM_SETCHARFORMAT , impostare il membro cbSize della struttura su sizeof(CHARFORMAT) o sizeof(CHARFORMAT2) indicare quale versione della struttura viene usata.

I membri szFaceName e bCharSet possono essere sovrascritti quando non validi per i caratteri, ad esempio Arial sui caratteri kanji.

Valore restituito

Se l'operazione ha esito positivo, il valore restituito è un valore diverso da zero.

Se l'operazione ha esito negativo, il valore restituito è zero.

Commenti

Se questo messaggio viene inviato più volte con gli stessi parametri, l'effetto sul testo viene disattivato. Ovvero, l'invio del messaggio una volta generato l'effetto, l'invio del messaggio annulla due volte l'effetto e così via.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Richedit.h

Vedi anche

Riferimento

CHARFORMAT

CHARFORMAT2