EM_SETCHARFORMAT message

Définit la mise en forme des caractères dans un contrôle d’édition enrichi.

Paramètres

wParam

Mise en forme de caractères qui s’applique au contrôle. Si ce paramètre est égal à zéro, le format de caractère par défaut est défini. Sinon, il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
SCF_ALL	Applique la mise en forme à tout le texte du contrôle. Non valide avec SCF_SELECTION ou SCF_WORD.
SCF_ASSOCIATEFONT	RichEdit 4.1 : Associe une police à un script donné, modifiant ainsi la police par défaut pour ce script. Pour spécifier la police, utilisez les membres suivants de CHARFORMAT2 : yHeight, bCharSet, bPitchAndFamily, szFaceName et lcid.
SCF_ASSOCIATEFONT2	RichEdit 4.1 : Associe une police de substitution (plan-2) à un script donné, modifiant ainsi la police par défaut de ce script. Pour spécifier la police, utilisez les membres suivants de CHARFORMAT2 : yHeight, bCharSet, bPitchAndFamily, szFaceName et lcid.
SCF_CHARREPFROMLCID	Obtient le répertoire de personnages du LCID.
SCF_DEFAULT	RichEdit 4.1 : Définit la police par défaut pour le contrôle.
SPF_DONTSETDEFAULT	Empêche la définition du format de paragraphe par défaut lorsque le contrôle d’édition enrichi est vide.
SCF_NOKBUPDATE	RichEdit 4.1 : Empêche le basculement du clavier pour qu’il corresponde à la police. Par exemple, si une police arabe est définie, normalement la fonctionnalité de clavier automatique pour les langues Bidi remplace le clavier par un clavier arabe.
SCF_SELECTION	Applique la mise en forme à la sélection actuelle. Si la sélection est vide, la mise en forme du caractère est appliquée au point d’insertion, et le nouveau format de caractère n’est en vigueur que jusqu’à ce que le point d’insertion change.
SPF_SETDEFAULT	Définit les attributs de mise en forme de paragraphe par défaut.
SCF_SMARTFONT	Appliquez la police uniquement si elle peut gérer le script.
SCF_USEUIRULES	RichEdit 4.1 : Utilisé avec SCF_SELECTION. Indique que le format provient d’une barre d’outils ou d’un autre outil d’interface utilisateur. Les règles de mise en forme de l’interface utilisateur doivent donc être utilisées au lieu de la mise en forme littérale.
SCF_WORD	Applique la mise en forme au ou aux mots sélectionnés. Si la sélection est vide mais que le point d’insertion se trouve à l’intérieur d’un mot, la mise en forme est appliquée au mot. La valeur SCF_WORD doit être utilisée conjointement avec la valeur SCF_SELECTION .

lParam

Pointeur vers une structure CHARFORMAT spécifiant la mise en forme de caractères à utiliser. Seuls les attributs de mise en forme spécifiés par le membre dwMask sont modifiés.

Microsoft Rich Edit 2.0 et versions ultérieures : ce paramètre peut être un pointeur vers une structure CHARFORMAT2 , qui est une extension de la structure CHARFORMAT . Avant d’envoyer le message EM_SETCHARFORMAT, définissez le membre sizeof(CHARFORMAT)cbSize de la structure sur ou sizeof(CHARFORMAT2) indiquez la version de la structure utilisée.

Les membres szFaceName et bCharSet peuvent être annulés lorsqu’ils ne sont pas valides pour les caractères, par exemple : Arial sur les caractères kanji.

Valeur retournée

Si l’opération réussit, la valeur de retour est différente de zéro.

Si l’opération échoue, la valeur de retour est zéro.

Notes

Si ce message est envoyé plusieurs fois avec les mêmes paramètres, l’effet sur le texte est activé. Autrement dit, l’envoi du message une fois produit l’effet, l’envoi du message deux fois annule l’effet, et ainsi de suite.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Richedit.h

Voir aussi

Référence

CHARFORMAT

CHARFORMAT2