CHARFORMAT2

[Esta é a documentação preliminar e estão sujeitos a alterações.]

A CHARFORMAT2 estrutura contém informações sobre a formatação de caractere em um Controlarar rich Editar. CHARFORMAT2 é uma extensão rich Editar 2.0 da estrutura CHARFORMAT . Rich Editar 2.0 permite que você use qualquer estrutura com as mensagens de EM_GETCHARFORMAT e EM_SETCHARFORMAT.

typedef struct _charformat2 {
    UINT cbSize;
    _WPAD _wPad1;
    DWORD dwMask;
    DWORD dwEffects;
    YHeight longo;
    YOffset longo;
    COLORREF crTextColor;
    BYTE bCharSet;
    BYTE bPitchAndFamily;
    WCHAR szFaceName [LF_FACESIZE];
    _WPAD _wPad2;
    PALAVRA wWeight;
    SSpacing curto;
    COLORREF crBackColor;
    LCID lcid;
    DWORD dwReserved;
    SStyle curto;
    PALAVRA wKerning;
    BYTE bUnderlineType;
    BYTE bAnimation;
    BYTE bRevAuthor;
    BYTE bReserved1;
} CHARFORMAT2 

Membros

cbSize
Especifica o tamanho, em bytes, dessa estrutura. Antes de passar essa estrutura para um Controlarar rich Editar, defina o cbSize para o tamanho da estrutura CHARFORMAT ou CHARFORMAT2 . Se cbSize é igual o tamanho de uma estrutura CHARFORMAT , o Controlarar usa somente os membros CHARFORMAT.
dwMask
Especifica as partes de CHARFORMAT2 estrutura que contém informações válidas. O dwMask membro pode ser uma combinação dos valores de dois conjuntos de sinalizadores de bit. Um conjunto indica os membros de estrutura são válidos. Outro conjunto indica os atributos válidos no membro dwEffects.

Defina os seguintes valores para indicar os membros de estrutura válido.
Valor Significado
CFM_ANIMATION O membro bAnimation é válido.
CFM_BACKCOLOR O membro crBackColor é válido.
CFM_CHARSET O bCharSet membro é válido.
CFM_COLOR O crTextColor membro é válido, a menos que o sinalizador CFE_AUTOCOLOR é definido no membro dwEffects.
CFM_FACE O membro szFaceName é válido.
CFM_KERNING O membro wKerning é válido.
CFM_LCID O lcid membro é válido.
CFM_OFFSET O membro yOffset é válido.
CFM_REVAUTHOR O membro bRevAuthor é válido.
CFM_SIZE O membro yHeight é válido.
CFM_SPACING O membro sSpacing é válido.
CFM_STYLE O membro sStyle é válido.
CFM_UNDERLINETYPE O membro bUnderlineType é válido.
CFM_WEIGHT O membro wWeight é válido.

Defina os seguintes valores para indicar os atributos válidos do membro dwEffects:
Valor Significado
CFM_ALLCAPS O valor CFE_ALLCAPS é válido.
CFM_BOLD O valor CFE_BOLD é válido.
CFM_COLOR O valor CFE_AUTOCOLOR é válido, ou o membro crTextColor é válido.
CFM_DISABLED O valor CFE_DISABLED é válido.
CFM_EMBOSS O valor CFE_EMBOSS é válido.
CFM_HIDDEN O valor CFE_HIDDEN é válido.
CFM_IMPRINT O valor CFE_IMPRINT é válido.
CFM_ITALIC O valor CFE_ITALIC é válido.
CFM_LINK O valor CFE_LINK é válido.
CFM_OUTLINE O valor CFE_OUTLINE é válido.
CFM_PROTECTED O valor CFE_PROTECTED é válido.
CFM_REVISED O valor CFE_REVISION é válido.
CFM_SHADOW O valor CFE_SHADOW é válido.
CFM_SMALLCAPS O valor CFE_SMALLCAPS é válido.
CFM_STRIKEOUT O valor CFE_STRIKEOUT é válido.
CFM_SUBSCRIPT Os valores CFE_SUBSCRIPT e CFE_SUPERSCRIPT são válidos.
CFM_SUPERSCRIPT Mesmo que CFM_SUBSCRIPT.
CFM_UNDERLINE. O valor CFE_UNDERLINE é válido.

dwEffects
Um conjunto de bit sinalizadores que especificar efeitos de caracteres. Alguns dos sinalizadores são incluídos somente para compatibilidade com interfaces de modelo de objeto de texto da Microsoft (TOM); o Controlarar rich Editar armazena o valor mas não usá-lo para exibir o texto.

Esse membro pode ser uma combinação dos seguintes valores.
Valor Significado
CFE_ALLCAPS Caracteres são letras maiúsculas. Não afeta a maneira que o Controlarar exibe o texto.
CFE_AUTOCOLOR A cor do texto é o valor de retorno de GetSysColor (COLOR_WINDOWTEXT). Se este sinalizador estiver definido, o membro de crTextColor é ignorado.
CFE_BOLD Caracteres estão em negrito.
CFE_DELETED Marca os caracteres como excluído.
CFE_EMBOSS Caracteres estão em alto relevo. Não afeta como o controle exibe o texto.
CFE_HIDDEN Caracteres não são exibidos. Não afeta como o controle exibe o texto.
CFE_IMPRINT Caracteres são exibidos como caracteres impressos. Não afeta como o controle exibe o texto.
CFE_ITALIC Caracteres são itálico.
CFE_LINK Um Controlarar rich Editar pode enviar mensagens de notificação de EN_LINK quando ele recebe mensagens do mouse enquanto o ponteiro do mouse está sobre o texto com o efeito CFE_LINK.
CFE_OUTLINE Caracteres são exibidos como caracteres de estrutura de tópicos. Não afeta como o controle exibe o texto.
CFE_PROTECTED Caracteres são protegidas; uma tentativa de modificá-los fará com que uma mensagem de notificação EN_PROTECTED.
CFE_REVISION Marcas de personagens como revisto.
CFE_SHADOW Caracteres são exibidos como caracteres sombreados. Não afeta como o controle exibe o texto.
CFE_SMALLCAPS Caracteres estão em letras maiúsculas pequenas. Não afeta como o controle exibe o texto.
CFE_STRIKEOUT Caracteres são inutilizadas.
CFE_SUBSCRIPT Os caracteres são subscrito. Os valores CFE_SUPERSCRIPT e CFE_SUBSCRIPT são mutuamente exclusivos. Para ambos os valores, o controle automaticamente calcula um deslocamento e um tamanho de fonte menor. Como alternativa, você pode usar os membros yHeight e yOffset para especificar explicitamente o tamanho da fonte e deslocamento para personagens e em expoente.
CFE_SUPERSCRIPT Caracteres são sobrescrito.
CFE_UNDERLINE Caracteres são sublinhados.

yHeight
Especifica a altura de caracteres, em twips. Um twip é 1/1440 de polegada ou 1/20 do ponto da impressora. Para usar este membro, definir o sinalizador CFM_SIZE in dwMask membro.
yOffset
Especifica o deslocamento de caractere, em twips, da linha de base. Se esse membro for positivo, que o personagem é um sobrescrito; se for negativo, o personagem é um subscrito. Para usar este membro, definir o sinalizador CFM_OFFSET in dwMask membro.
crTextColor
Especifica a cor do texto. Para usar este membro, defina o sinalizador CFM_COLOR in dwMask membro. Este membro será ignorado se o efeito de caractere CFE_AUTOCOLOR é especificado.
bCharSet
Especifica o caractere definido valor, que pode ser um dos valores especificados para o membro lfCharSet a estrutura de LOGFONT . Para usar este membro, definir o sinalizador CFM_CHARSET in dwMask membro.
bPitchAndFamily
Especifica a família de fontes e o arremesso. Esse membro é o mesmo que o membro lfPitchAndFamily a estrutura de LOGFONT .
szFaceName
Uma matriz de caracteres null-terminated especificando o nome de face da fonte. Para usar este membro, definir o sinalizador CFM_FACE in dwMask membro.
wWeight
Especifica a espessura da fonte. Esse membro é o mesmo que o lfWeight membro da estrutura LOGFONT . Para usar este membro, definir o sinalizador CFM_WEIGHT in dwMask membro.
sSpacing
Especifica o espaço horizontal, em twips, entre as letras. Esse valor não tem efeito sobre o texto exibido por um Controlarar rich Editar; é incluído para compatibilidade com interfaces de modelo de objeto de texto da Microsoft (TOM). Para usar este membro, definir o sinalizador CFM_SPACING in dwMask membro.
crBackColor
Especifica a cor de fundo. Para usar este membro, definir o sinalizador CFM_BACKCOLOR in dwMask membro.
lcid
Especifica um identificador de localidade de 32 bits que contém um identificador de idioma no word inferior e um identificador de classificação e valor reservado na palavra superior. Este membro não tem efeito sobre o texto exibido por um Controlarar rich Editar, mas verificadores ortográfico e gramatical pode usá-lo para lidar com problemas de linguagem-dependente. Você pode usar o macro MAKELCID para criar um valor LCID . Para usar este membro, definir o sinalizador CFM_LCID in dwMask membro.
dwReserved
Reservados; deve ser zero.
sStyle
Especifica um identificador de estilo. Esse valor não tem efeito sobre o texto exibido por um Controlarar rich Editar; é incluído para compatibilidade com interfaces de modelo de objeto de texto da Microsoft (TOM). Para usar este membro, definir o sinalizador CFM_STYLE in dwMask membro.
wKerning
Especifica o tamanho de twip acima que para kerning os caracteres. Esse valor não tem efeito sobre o texto exibido por um Controlarar rich Editar; é incluído para compatibilidade com interfaces de TOM. Para usar este membro, definir o sinalizador CFM_KERNING in dwMask membro.
bUnderlineType
Especifica o tipo de sublinhado. Para usar este membro, defina o sinalizador CFM_UNDERLINETYPE in dwMask membro. Esse membro pode ser uma dos seguinte valores.
Valor Significado
CFU_CF1UNDERLINE Mapear CHARFORMATdo bit sublinhado para CHARFORMAT2.
CFU_INVERT Para composição do IME fake uma seleção.
CFU_UNDERLINE Sublinhado sólido.
CFU_UNDERLINEDOTTED Texto sublinhado pontilhado. O rich Editar Controlarar exibe o texto com um sublinhado sólido.
CFU_UNDERLINEDOUBLE Texto com duplo sublinhado. O rich Editar Controlarar exibe o texto com um sublinhado sólido.
CFU_UNDERLINENONE Não sublinhado. Este é o padrão.
CFU_UNDERLINEWORD Sublinhar palavras apenas. O rich Editar Controlarar exibe o texto com um sublinhado sólido.

bAnimation
Especifica a animação de texto. Esse valor não tem efeito sobre o texto exibido por um Controlarar rich Editar; é incluído para compatibilidade com interfaces de TOM. Para usar este membro, definir o sinalizador CFM_ANIMATION in dwMask membro.
bRevAuthor
Especifica um índice que identifica o autor fazendo uma revisão. O Controlarar rich Editar usa cores de texto diferentes para cada índice de autores diferentes. Para usar este membro, definir o sinalizador CFM_REVAUTHOR in dwMask membro.
bReserved1
Reservados; deve ser zero.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no richedit.h.
Unicode:Definidos como estruturas ANSI e Unicode.

Ver também

Visão geral sobre controles de Editar Rich, Rich Editar estruturas, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index