EM_SETCHARFORMAT сообщение

Задает форматирование символов в элементе управления полнофункционированным редактированием.

Параметры

wParam

Форматирование символов, применяемое к элементу управления . Если этот параметр равен нулю, устанавливается символьный формат по умолчанию. В противном случае это может быть одно из следующих значений.

Значение	Значение
SCF_ALL	Применяет форматирование ко всему тексту в элементе управления . Недопустимо для SCF_SELECTION или SCF_WORD.
SCF_ASSOCIATEFONT	RichEdit 4.1: Связывает шрифт с заданным скриптом, тем самым изменяя шрифт по умолчанию для этого скрипта. Чтобы указать шрифт, используйте следующие элементы CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName и lcid.
SCF_ASSOCIATEFONT2	RichEdit 4.1: Связывает суррогатный шрифт (плоскость 2) с заданным скриптом, тем самым изменяя шрифт по умолчанию для этого скрипта. Чтобы указать шрифт, используйте следующие элементы CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName и lcid.
SCF_CHARREPFROMLCID	Получает репертуар персонажей из LCID.
SCF_DEFAULT	RichEdit 4.1: Задает шрифт по умолчанию для элемента управления .
SPF_DONTSETDEFAULT	Запрещает задавать формат абзаца по умолчанию, если элемент управления полнофункционированного редактирования пуст.
SCF_NOKBUPDATE	RichEdit 4.1: Запрещает переключение клавиатуры в соответствии со шрифтом. Например, если задан арабский шрифт, обычно функция автоматической клавиатуры для языков Биди изменяет клавиатуру на арабскую клавиатуру.
SCF_SELECTION	Применяет форматирование к текущему выделенному фрагменту. Если выделенный фрагмент пуст, форматирование символов применяется к точке вставки, а новый формат символов действует только до изменения точки вставки.
SPF_SETDEFAULT	Задает атрибуты форматирования абзаца по умолчанию.
SCF_SMARTFONT	Применяйте шрифт только в том случае, если он может обрабатывать скрипт.
SCF_USEUIRULES	RichEdit 4.1: Используется с SCF_SELECTION. Указывает, что формат получен из панели инструментов или другого средства пользовательского интерфейса, поэтому вместо форматирования литерала следует использовать правила форматирования пользовательского интерфейса.
SCF_WORD	Применяет форматирование к выделенному слову или словам. Если выделенный фрагмент пуст, но точка вставки находится внутри слова, к слову применяется форматирование. Значение SCF_WORD должно использоваться вместе со значением SCF_SELECTION .

lParam

Указатель на структуру CHARFORMAT , указывающую используемое форматирование символов. Изменяются только атрибуты форматирования, заданные членом dwMask .

Microsoft Rich Edit 2.0 и более поздних версий: этот параметр может быть указателем на структуру CHARFORMAT2 , которая является расширением структуры CHARFORMAT . Перед отправкой сообщения EM_SETCHARFORMAT задайте для элемента sizeof(CHARFORMAT)cbSize структуры значение или sizeof(CHARFORMAT2) укажите, какая версия структуры используется.

Члены szFaceName и bCharSet могут быть переопределены, если они недопустимы для символов, например: Arial для символов кандзи.

Возвращаемое значение

Если операция выполнена успешно, возвращается ненулевое значение.

Если операция завершается сбоем, возвращаемое значение равно нулю.

Комментарии

Если это сообщение отправляется несколько раз с теми же параметрами, влияние на текст переключается. То есть отправка сообщения один раз дает эффект, отправка сообщения дважды отменяет эффект и т. д.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Richedit.h

См. также раздел

Справочные материалы

CHARFORMAT

CHARFORMAT2