CHARFORMAT2

[Це попередні документації та тема змінити].

CHARFORMAT2 структура містить відомості про форматування в елементі керування для форматованого тексту. CHARFORMAT2 є розширенням форматується 2.0 CHARFORMAT структури. Форматується 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 lcid;
    DWORD dwReserved;
    КОРОТКИЙ sStyle;
    СЛОВО wKerning;
    БАЙТ bUnderlineType;
    БАЙТ bAnimation;
    БАЙТ bRevAuthor;
    БАЙТ bReserved1;
} CHARFORMAT2 

Члени

cbSize
Визначає розмір у байтах, ця структура. До прийняття цієї структури до елемента керування для форматованого тексту, встановіть cbSize розмір структури CHARFORMAT або CHARFORMAT2 . Якщо 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 текстовий об'єкт моделі (Том); керування форматованого тексту зберігаються значення, але не використовувати його для відображення тексту.

Цей компонент може бути поєднання таких значень.
Значення Значення
CFE_ALLCAPS Символи є великими літерами. Не впливає на відображення елемента керування текст.
CFE_AUTOCOLOR Колір тексту є значення GetSysColor (COLOR_WINDOWTEXT). Якщо цей прапор, ігнорується, член crTextColor.
CFE_BOLD Символи є жирним шрифтом.
CFE_DELETED Позначає символи, як видалене.
CFE_EMBOSS Є тиснення символів. Не впливає на відображення тексту елемента керування.
CFE_HIDDEN Не відображаються символи. Не впливає на відображення тексту елемента керування.
CFE_IMPRINT Символи відображаються як відображені символи. Не впливає на відображення тексту елемента керування.
CFE_ITALIC Символи відображаються курсивом.
CFE_LINK Елемент керування для форматованого тексту можна надіслати повідомлення про 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
Визначає висоту символу, твипів. На twip — 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
Визначає положення простір твипів, між літерами. Це значення має ніякого ефекту на текст, який відображається на форматується контролю; він входить, для сумісності з інтерфейсів Microsoft текстовий об'єкт моделі (Том). Щоб використовувати цей компонент, встановити прапор CFM_SPACING в dwMask член.
crBackColor
Визначає колір тла. Щоб використовувати цей компонент, встановити прапор CFM_BACKCOLOR в dwMask член.
lcid
Визначає 32-розрядних локалі ідентифікатор, який містить ідентифікатор мови в нижче слово і сортування ідентифікатор і зарезервовані значення у верхньому word. Цей компонент має ніякого ефекту на текст, який відображається на керування форматованого тексту, але перевірка орфографії та граматики можна використовувати для вирішення проблеми залежать від мови. Ви можете використовувати в MAKELCID -макрос для створення значення LCID. Щоб використовувати цей компонент, встановити прапор CFM_LCID в dwMask член.
dwReserved
Захищені; повинні бути нульовим.
sStyle
Визначає стиль маркера. Це значення має ніякого ефекту на текст, який відображається на форматується контролю; він входить, для сумісності з інтерфейсів Microsoft текстовий об'єкт моделі (Том). Щоб використовувати цей компонент, встановити прапор CFM_STYLE в dwMask член.
wKerning
Визначає розмір twip над яким кернінг характер. Це значення має ніякого ефекту на текст, який відображається на форматується контролю; він входить, для сумісності з Тома інтерфейсів. Щоб використовувати цей компонент, встановити прапор CFM_KERNING в dwMask член.
bUnderlineType
Визначає тип підкреслення. Щоб використовувати цей компонент, встановити прапор CFM_UNDERLINETYPE в dwMask член. Цей компонент може бути одне з таких значень.
Значення Значення
CFU_CF1UNDERLINE Карта CHARFORMATбіт підкреслення до CHARFORMAT2.
CFU_INVERT Для IME склад fake виділення.
CFU_UNDERLINE Тверді підкреслення.
CFU_UNDERLINEDOTTED Пунктирною підкреслений текст. Форматованого тексту відображається текст з твердого підкреслення.
CFU_UNDERLINEDOUBLE Подвійний підкреслений текст. Форматованого тексту відображається текст з твердого підкреслення.
CFU_UNDERLINENONE Без підкреслення. Це за замовчуванням.
CFU_UNDERLINEWORD Підкреслювати лише слова. Форматованого тексту відображається текст з твердого підкреслення.

bAnimation
Визначає анімації тексту. Це значення має ніякого ефекту на текст, який відображається на форматується контролю; він входить, для сумісності з Тома інтерфейсів. Щоб використовувати цей компонент, встановити прапор CFM_ANIMATION в dwMask член.
bRevAuthor
Визначає індекс, що визначає автор робить перегляд. Керування форматується використовує кольори для кожного інший автор індекс. Щоб використовувати цей компонент, встановити прапор CFM_REVAUTHOR в dwMask член.
bReserved1
Захищені; повинні бути нульовим.

QuickInfo

nbsp; Windows &NT: вимагає 4.0 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Не підтримується.
Заголовка:Оголошена в richedit.h.
Юнікод:Визначено як Unicode та ANSI структури.

Дивіться також

Багаті редагувати елементи керування огляд, Rich редагування структури, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index