CHARFORMAT2

[To wstępne dokumentacji oraz z zastrzeżeniem zmiany.]

Struktura CHARFORMAT2 zawiera informacje o formatowanie znaków w formancie edycji wzbogaconej. CHARFORMAT2 to rozszerzenie edycji wzbogaconej 2.0 struktury CHARFORMAT . Edycji wzbogaconej 2.0 pozwala na używanie jednej struktury wiadomościami EM_GETCHARFORMAT i EM_SETCHARFORMAT.

element TypeDef struct _charformat2 {}
    UINT cbSize;
    _WPAD _wPad1;
    DWORD dwMask;
    DWORD dwEffects;
    LONG yHeight;
    LONG yOffset;
    COLORREF crTextColor;
    BAJT bCharSet;
    BAJT bPitchAndFamily;
    WCHAR szFaceName [LF_FACESIZE];
    _WPAD _wPad2;
    Program WORD wWeight;
    KRÓTKIE sSpacing;
    COLORREF crBackColor;
    Identyfikator LCID lcid;
    DWORD dwReserved;
    KRÓTKIE sStyle;
    Program WORD wKerning;
    BAJT bUnderlineType;
    BAJT bAnimation;
    BAJT bRevAuthor;
    BAJT bReserved1;
} CHARFORMAT2 

Członkowie

cbSize
Określa rozmiar, w bajtach, w tej struktury. Przed przekazaniem tej struktury na formant edycji wzbogaconej, ustaw cbSize rozmiar struktury CHARFORMAT lub CHARFORMAT2 . Jeśli cbSize jest równa rozmiarowi struktury CHARFORMAT , kontroli używa tylko członkowie CHARFORMAT.
dwMask
Określa części konstrukcji CHARFORMAT2 , które zawierają ważne informacje. Element dwMask może być kombinacją wartości z dwóch zestawów flag bitowych. Jeden zestaw wskazuje elementów konstrukcji, które są prawidłowe. Inny zestaw wskazuje prawidłowe atrybuty członka dwEffects.

Ustaw następujące wartości do wskazywania elementów konstrukcji ważne.
Wartość Znaczenie
CFM_ANIMATION Element bAnimation jest prawidłowa.
CFM_BACKCOLOR Element crBackColor jest prawidłowa.
CFM_CHARSET Element bCharSet jest prawidłowa.
CFM_COLOR Element crTextColor jest prawidłowy, chyba że członek dwEffects jest ustawiona flaga CFE_AUTOCOLOR.
CFM_FACE Element szFaceName jest prawidłowa.
CFM_KERNING Element wKerning jest prawidłowa.
CFM_LCID Członek lcid jest prawidłową.
CFM_OFFSET Element yOffset jest prawidłowa.
CFM_REVAUTHOR Element bRevAuthor jest prawidłowa.
CFM_SIZE Element yHeight jest prawidłowa.
CFM_SPACING Element sSpacing jest prawidłowa.
CFM_STYLE Element sStyle jest prawidłowa.
CFM_UNDERLINETYPE Element bUnderlineType jest prawidłowa.
CFM_WEIGHT Element wWeight jest prawidłowa.

Ustaw następujące wartości do wskazania prawidłowe atrybuty Państwa dwEffects:
Wartość Znaczenie
CFM_ALLCAPS Wartość CFE_ALLCAPS jest prawidłowa.
CFM_BOLD Wartość CFE_BOLD jest prawidłowa.
CFM_COLOR Wartość CFE_AUTOCOLOR jest prawidłowa, lub członek crTextColor jest prawidłowa.
CFM_DISABLED Wartość CFE_DISABLED jest prawidłowa.
CFM_EMBOSS Wartość CFE_EMBOSS jest prawidłowa.
CFM_HIDDEN Wartość CFE_HIDDEN jest prawidłowa.
CFM_IMPRINT Wartość CFE_IMPRINT jest prawidłowa.
CFM_ITALIC Wartość CFE_ITALIC jest prawidłowa.
CFM_LINK Wartość CFE_LINK jest prawidłowa.
CFM_OUTLINE Wartość CFE_OUTLINE jest prawidłowa.
CFM_PROTECTED Wartość CFE_PROTECTED jest prawidłowa.
CFM_REVISED Wartość CFE_REVISION jest prawidłowa.
CFM_SHADOW Wartość CFE_SHADOW jest prawidłowa.
CFM_SMALLCAPS Wartość CFE_SMALLCAPS jest prawidłowa.
CFM_STRIKEOUT Wartość CFE_STRIKEOUT jest prawidłowa.
CFM_SUBSCRIPT Wartości CFE_SUBSCRIPT i CFE_SUPERSCRIPT są prawidłowe.
CFM_SUPERSCRIPT Takie same jak CFM_SUBSCRIPT.
CFM_UNDERLINE. Wartość CFE_UNDERLINE jest prawidłowa.

dwEffects
Zestaw flag bitowych, które określają efekty znakowe. Niektóre z flag są uwzględniane tylko dla zachowania zgodności z interfejsów Microsoft tekst obiektu modelu (TOM); Formant edycji wzbogaconej przechowuje wartości, lecz nie używać do wyświetlania tekstu.

Ten element może być kombinacją następujących wartości.
Wartość Znaczenie
CFE_ALLCAPS Znaki są wielkimi literami. Nie wpływa na sposób, w jaki formant wyświetla tekst.
CFE_AUTOCOLOR Kolor tekstu jest wartość zwracany GetSysColor (COLOR_WINDOWTEXT). Jeśli ta flaga będzie ustawiona, członek crTextColor jest ignorowane.
CFE_BOLD Znaki są pogrubione.
CFE_DELETED Znaki znaki jako usunięte.
CFE_EMBOSS Znaki są wypukła. Nie wpływa na sposób kontroli wyświetla tekst.
CFE_HIDDEN Znaki nie są wyświetlane. Nie wpływa na sposób kontroli wyświetla tekst.
CFE_IMPRINT Znaki są wyświetlane jako nadrukowany znaków. Nie wpływa na sposób kontroli wyświetla tekst.
CFE_ITALIC Znaki są kursywa.
CFE_LINK Formant edycji wzbogaconej można wysyłać komunikaty powiadamiające EN_LINK , po odebraniu wiadomości myszy, gdy wskaźnik myszy znajduje się nad tekst z efektem CFE_LINK.
CFE_OUTLINE Znaki są wyświetlane jako znaki konspektu. Nie wpływa na sposób kontroli wyświetla tekst.
CFE_PROTECTED Znaki są chronione; próba ich modyfikować spowoduje, że powiadomienie EN_PROTECTED.
CFE_REVISION Znaki znaków zmienione.
CFE_SHADOW Znaki są wyświetlane jako znaki cieniowany. Nie wpływa na sposób kontroli wyświetla tekst.
CFE_SMALLCAPS Znaki są w kapitaliki. Nie wpływa na sposób kontroli wyświetla tekst.
CFE_STRIKEOUT Znaki są przekreślony.
CFE_SUBSCRIPT Znaki są indeks dolny. Wartości CFE_SUPERSCRIPT i CFE_SUBSCRIPT się wzajemnie wykluczają. Dla obu wartości formant automatycznie oblicza przesunięcia i mniejszy rozmiar czcionki. Alternatywnie można użyć członków yHeight i yOffset jawnie określić rozmiar czcionki oraz przesunięcie znaków indeksach dolnym i górnym.
CFE_SUPERSCRIPT Znaki są Górny.
CFE_UNDERLINE Znaki są podkreślane.

yHeight
Określa wysokość znaków w twipach. Twip to 1/1440 cala lub 1/20 punktów drukarki. Aby użyć tego członka, należy ustawić flagę CFM_SIZE członka dwMask.
yOffset
Określa przesunięcie znaku w twipach od linii bazowej. Jeśli ten członek jest dodatnia, znak jest Górny; Jeśli jest ujemna, znak jest indeks dolny. Aby użyć tego członka, należy ustawić flagę CFM_OFFSET członka dwMask.
crTextColor
Określa kolor tekstu. Aby użyć tego członka, należy ustawić flagę CFM_COLOR w elemencie dwMask . Członek ten jest ignorowany, jeśli jest określony efekt znaku CFE_AUTOCOLOR.
bCharSet
Określa zestaw znaków wartości, która może być jedną z wartości określone dla członka lfCharSet LOGFONT struktury. Aby użyć tego członka, należy ustawić flagę CFM_CHARSET członka dwMask.
bPitchAndFamily
Określa rodzinę czcionek i skoku. Ten element jest taki sam, jako członek lfPitchAndFamily struktury LOGFONT .
szFaceName
Tablica zakończona znakiem null znaku określający nazwę czcionki. Aby użyć tego członka, należy ustawić flagę CFM_FACE członka dwMask.
wWeight
Określa grubość czcionki. Ten element jest taki sam, jako członek lfWeight struktury LOGFONT . Aby użyć tego członka, należy ustawić flagę CFM_WEIGHT członka dwMask.
sSpacing
Określa odstęp w poziomie, w twipach między literami. Wartość ta nie ma wpływu na tekst wyświetlany przez formant edycji wzbogaconej; jest włączone dla zachowania zgodności z interfejsów Microsoft tekst obiektu modelu (TOM). Aby użyć tego członka, należy ustawić flagę CFM_SPACING członka dwMask.
crBackColor
Określa kolor tła. Aby użyć tego członka, należy ustawić flagę CFM_BACKCOLOR członka dwMask.
identyfikator lcid
Określa identyfikator regionalny 32-bitowe, zawierający identyfikator języka w programie word niższe oraz identyfikatora sortowania i wartość zastrzeżona w górnej programu word. Członek ten nie ma wpływu na tekst wyświetlany przez formant edycji wzbogaconej, ale sprawdzania pisowni i gramatyki można używać go do rozwiązywania problemów zależnych od języka. Można użyć MAKELCID makro do tworzenia wartości LCID. Aby użyć tego członka, należy ustawić flagę CFM_LCID członka dwMask.
dwReserved
Zarezerwowane; musi mieć wartość zero.
sStyle
Określa dojście stylu. Wartość ta nie ma wpływu na tekst wyświetlany przez formant edycji wzbogaconej; jest włączone dla zachowania zgodności z interfejsów Microsoft tekst obiektu modelu (TOM). Aby użyć tego członka, należy ustawić flagę CFM_STYLE członka dwMask.
wKerning
Określa rozmiar twip, powyżej którego wykonując znaku. Wartość ta nie ma wpływu na tekst wyświetlany przez formant edycji wzbogaconej; jest włączone dla zachowania zgodności z TOM interfejsów. Aby użyć tego członka, należy ustawić flagę CFM_KERNING członka dwMask.
bUnderlineType
Określa typ podkreślenia. Aby użyć tego członka, należy ustawić flagę CFM_UNDERLINETYPE w elemencie dwMask . Ten członek może mieć jedną z następujących wartości.
Wartość Znaczenie
CFU_CF1UNDERLINE Mapa CHARFORMATbitowe podkreślenie do CHARFORMAT2.
CFU_INVERT W skład edytora IME fałszywe zaznaczenia.
CFU_UNDERLINE Ciągłą linią.
CFU_UNDERLINEDOTTED Kropkowane podkreślenie. Formant edycji wzbogaconej wyświetla tekst podkreślony linią ciągłą.
CFU_UNDERLINEDOUBLE Podwójnie podkreolony tekst. Formant edycji wzbogaconej wyświetla tekst podkreślony linią ciągłą.
CFU_UNDERLINENONE Nie podkreślenie. To jest wartość domyślna.
CFU_UNDERLINEWORD Podkreślanie tylko wyrazy. Formant edycji wzbogaconej wyświetla tekst podkreślony linią ciągłą.

bAnimation
Określa animacji tekstu. Wartość ta nie ma wpływu na tekst wyświetlany przez formant edycji wzbogaconej; jest włączone dla zachowania zgodności z TOM interfejsów. Aby użyć tego członka, należy ustawić flagę CFM_ANIMATION członka dwMask.
bRevAuthor
Określa indeks, który identyfikuje autora dokonanie rewizji. Formant edycji wzbogaconej używa kolorów inny tekst dla każdego wskaźnika innego autora. Aby użyć tego członka, należy ustawić flagę CFM_REVAUTHOR członka dwMask.
bReserved1
Zarezerwowane; musi mieć wartość zero.

Skrócone informacje

nbsp; Windows &NT: wymaga w wersji 4.0 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w richedit.h.
Unicode:Zdefiniowane jako struktur Unicode i ANSI.

Zobacz też

Bogate edytować Omówienie kontroli, Rich Edit struktur CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index