CHARFORMAT2

[Это предварительный документации и темы для изменения].

CHARFORMAT2 структура содержит сведения о форматирование в элементе управления rich edit. CHARFORMAT2 — расширение rich edit 2.0 CHARFORMAT структуры. Rich edit 2.0 позволяет использовать любой структуры с EM_GETCHARFORMAT и EM_SETCHARFORMAT сообщений.

typedef struct _charformat2 {}
    UINT cbSize;
    _WPAD _wPad1;
    DWORD dwMask;
    DWORD dwEffects;
    ДЛИННЫЕ yHeight;
    ДЛИННЫЕ yOffset;
    COLORREF crTextColor;
    БАЙТ bCharSet;
    БАЙТ bPitchAndFamily;
    WCHAR szFaceName [LF_FACESIZE];
    _WPAD _wPad2;
    СЛОВО wWeight;
    КОРОТКИЕ sSpacing;
    COLORREF crBackColor;
    Код языка lcid;
    DWORD dwReserved;
    КОРОТКИЕ sStyle;
    СЛОВО wKerning;
    БАЙТ bUnderlineType;
    БАЙТ bAnimation;
    БАЙТ bRevAuthor;
    БАЙТ bReserved1;
} CHARFORMAT2 

Члены

cbSize
Указывает размер в байтах этой структуры. Перед передачей этой структуры в элемент управления rich edit, установите размер CHARFORMAT или CHARFORMAT2 структуры cbSize . Если cbSize равен размер CHARFORMAT структуры, элемент управления использует только члены CHARFORMAT.
dwMask
Задает части CHARFORMAT2 структуры, которые содержат актуальную информацию. DwMask член может быть комбинацией значений из двух наборов битовых флагов. Один набор указывает членов структуры, которые являются допустимыми. Еще один набор показывает допустимые атрибуты в элементе dwEffects.

Установите следующие значения для указания допустимой структуры членов.
Значение Значение
CFM_ANIMATION BAnimation элемент действителен.
CFM_BACKCOLOR CrBackColor элемент действителен.
CFM_CHARSET BCharSet элемент действителен.
CFM_COLOR CrTextColor член является действительным, если не установлен флаг CFE_AUTOCOLOR в dwEffects -членов.
CFM_FACE SzFaceName элемент действителен.
CFM_KERNING WKerning элемент действителен.
CFM_LCID Lcid элемент действителен.
CFM_OFFSET YOffset элемент действителен.
CFM_REVAUTHOR BRevAuthor элемент действителен.
CFM_SIZE YHeight элемент действителен.
CFM_SPACING SSpacing элемент действителен.
CFM_STYLE SStyle элемент действителен.
CFM_UNDERLINETYPE BUnderlineType элемент действителен.
CFM_WEIGHT WWeight элемент действителен.

Установите следующие значения для указания допустимых атрибутов dwEffects члена:
Значение Значение
CFM_ALLCAPS Значение CFE_ALLCAPS является допустимым.
CFM_BOLD Значение CFE_BOLD является допустимым.
CFM_COLOR Значение CFE_AUTOCOLOR является допустимым, или crTextColor элемент действителен.
CFM_DISABLED Значение CFE_DISABLED является допустимым.
CFM_EMBOSS Значение CFE_EMBOSS является допустимым.
CFM_HIDDEN Значение CFE_HIDDEN является допустимым.
CFM_IMPRINT Значение CFE_IMPRINT является допустимым.
CFM_ITALIC Значение CFE_ITALIC является допустимым.
CFM_LINK Значение CFE_LINK является допустимым.
CFM_OUTLINE Значение CFE_OUTLINE является допустимым.
CFM_PROTECTED Значение CFE_PROTECTED является допустимым.
CFM_REVISED Значение CFE_REVISION является допустимым.
CFM_SHADOW Значение CFE_SHADOW является допустимым.
CFM_SMALLCAPS Значение CFE_SMALLCAPS является допустимым.
CFM_STRIKEOUT Значение CFE_STRIKEOUT является допустимым.
CFM_SUBSCRIPT Допустимы значения CFE_SUBSCRIPT и CFE_SUPERSCRIPT.
CFM_SUPERSCRIPT Же самое, что CFM_SUBSCRIPT.
CFM_UNDERLINE. Значение CFE_UNDERLINE является допустимым.

dwEffects
Набор битовых флагов, которые определяют характер эффектов. Некоторые из флагов включена только для совместимости с интерфейсами модели объектов Microsoft текста (Иван); элемент управления rich edit сохраняет значение, но не использовать его для отображения текста.

Этот член может быть комбинацией следующих значений.
Значение Значение
CFE_ALLCAPS Такими символами являются все прописные буквы. Не влияет на способ, элемент управления отображает текст.
CFE_AUTOCOLOR Цвет текста — значение, возвращаемое GetSysColor (COLOR_WINDOWTEXT). Если этот флаг установлен, элемент crTextColor игнорируется.
CFE_BOLD Символы жирным.
CFE_DELETED Помечает персонажи как удаленный.
CFE_EMBOSS Тиснение символов. Не влияет на как элемент управления отображает текст.
CFE_HIDDEN Символы не отображаются. Не влияет на как элемент управления отображает текст.
CFE_IMPRINT Символы отображаются как отпечатанные символов. Не влияет на как элемент управления отображает текст.
CFE_ITALIC Персонажи курсивом.
CFE_LINK Элемент управления rich edit сообщения можно отправлять EN_LINK уведомления при получении сообщения от мыши, когда указатель мыши находится над текста с эффектом CFE_LINK.
CFE_OUTLINE Символы отображаются в виде структурированных символов. Не влияет на как элемент управления отображает текст.
CFE_PROTECTED Знаки защищены; попытка изменить их вызовет сообщение уведомления EN_PROTECTED.
CFE_REVISION Знаки символы как пересмотренные.
CFE_SHADOW Символы отображаются как затененный символов. Не влияет на как элемент управления отображает текст.
CFE_SMALLCAPS Символы находятся в малых прописных букв. Не влияет на как элемент управления отображает текст.
CFE_STRIKEOUT Исключены знаки.
CFE_SUBSCRIPT Символы, значения индекса. Значения CFE_SUPERSCRIPT и CFE_SUBSCRIPT являются взаимно исключающими. Для обоих значений элемент управления автоматически вычисляет смещение и меньший размер шрифта. В качестве альтернативы можно использовать элементы yHeight и yOffset для явного указания размера и шрифта смещение для надстрочных и подстрочных символов.
CFE_SUPERSCRIPT Такими символами являются верхний индекс.
CFE_UNDERLINE Персонажи подчеркнуты.

yHeight
Определяет высоту символов в твипах. Твип является 1/1440 дюйма, или 1/20 из точки принтера. Чтобы использовать этот член, установите флаг CFM_SIZE в dwMask -членов.
yOffset
Определяет смещение символа в твипах, от базовой линии. Если этот элемент является положительным, символ является верхний; Если отрицательный, символ является индекс. Чтобы использовать этот член, установите флаг CFM_OFFSET в dwMask -членов.
crTextColor
Определяет цвет текста. Чтобы использовать этот член, установите флаг CFM_COLOR в dwMask -членов. Этот элемент игнорируется, если указанный символ эффект CFE_AUTOCOLOR.
bCharSet
Определяет набор символов значение, которое может быть одним из значений, указанных для члена lfCharSet структуры LOGFONT . Чтобы использовать этот член, установите флаг CFM_CHARSET в dwMask -членов.
bPitchAndFamily
Указывает семейство шрифтов и смолой. Этот член является таким же, как член lfPitchAndFamily структуры LOGFONT .
szFaceName
Массив символов, заканчивающейся пустым, указывая имя гарнитуры шрифта. Чтобы использовать этот член, установите флаг CFM_FACE в dwMask -членов.
wWeight
Задает плотность шрифта. Этот член является таким же, как член lfWeight структуры LOGFONT . Чтобы использовать этот член, установите флаг CFM_WEIGHT в dwMask -членов.
sSpacing
Определяет горизонтальное пространство в твипах, между буквами. Это значение не влияет на текст, отображаемый на элементе управления rich edit; Он включен для обеспечения совместимости с интерфейсами модели объектов Microsoft текста (Иван). Чтобы использовать этот член, установите флаг CFM_SPACING в dwMask -членов.
crBackColor
Задает цвет фона. Чтобы использовать этот член, установите флаг CFM_BACKCOLOR в dwMask -членов.
код языка
Задает идентификатор языка 32-разрядных, содержащий идентификатор языка в нижнем word и сортировки идентификатора и зарезервированное значение в верхнем слова. Этот член не влияет на текст, отображаемый на элементе управления rich edit, но орфографии и грамматики могут использовать его для решения проблем зависит от языка. Вы можете использовать MAKELCID макрос для создания значения LCID. Чтобы использовать этот член, установите флаг CFM_LCID в dwMask -членов.
dwReserved
Защищены; должно быть равно нулю.
sStyle
Задает стиль маркера. Это значение не влияет на текст, отображаемый на элементе управления rich edit; Он включен для обеспечения совместимости с интерфейсами модели объектов Microsoft текста (Иван). Чтобы использовать этот член, установите флаг CFM_STYLE в dwMask -членов.
wKerning
Определяет размер twip выше для кернинг характер. Это значение не влияет на текст, отображаемый на элементе управления rich edit; Он включен для обеспечения совместимости с интерфейсами томом. Чтобы использовать этот член, установите флаг CFM_KERNING в dwMask -членов.
bUnderlineType
Указывает тип подчеркивания. Чтобы использовать этот член, установите флаг CFM_UNDERLINETYPE в dwMask -членов. Этот член может быть одним из следующих значений.
Значение Значение
CFU_CF1UNDERLINE Карта CHARFORMATбит подчеркивания для CHARFORMAT2.
CFU_INVERT Для композиции IME поддельные выбор.
CFU_UNDERLINE Сплошной линией.
CFU_UNDERLINEDOTTED Пунктир подчеркнутый текст. Элемент управления rich edit отображает текст сплошной линией.
CFU_UNDERLINEDOUBLE Текст с двойным подчеркиванием. Элемент управления rich edit отображает текст сплошной линией.
CFU_UNDERLINENONE Без подчеркивания. Это значение по умолчанию.
CFU_UNDERLINEWORD Подчеркнуть только слова. Элемент управления rich edit отображает текст сплошной линией.

bAnimation
Указывает текст анимации. Это значение не влияет на текст, отображаемый на элементе управления rich edit; Он включен для обеспечения совместимости с интерфейсами томом. Чтобы использовать этот член, установите флаг CFM_ANIMATION в dwMask -членов.
bRevAuthor
Определяет индекс, который идентифицирует автора, делая пересмотра. Элемент управления rich edit использует различные текстовые цвета для каждого индекса, другой автор. Чтобы использовать этот член, установите флаг CFM_REVAUTHOR в dwMask -членов.
bReserved1
Защищены; должно быть равно нулю.

QuickInfo

nbsp; Windows &NT: требует версии 4.0 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в richedit.h.
Юникод:Определяется как структуры Unicode и ANSI.

Родственные слова

Rich Edit обзор управления, структуры Rich Edit, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor LOGFONT, MAKELCID

Index