CHARFORMAT2A estrutura (richedit.h)

Contém informações sobre a formatação de caracteres em um controle de edição avançada. CHARFORMAT2 é uma extensão do Microsoft Rich Edit 2.0 da estrutura CHARFORMAT . O Microsoft Rich Edit 2.0 permite que você use qualquer estrutura com as mensagens EM_GETCHARFORMAT e EM_SETCHARFORMAT.

Sintaxe

struct CHARFORMAT2A : _charformat {
  WORD     wWeight;
  SHORT    sSpacing;
  COLORREF crBackColor;
  LCID     lcid;
  union {
    DWORD dwReserved;
    DWORD dwCookie;
  };
  DWORD    dwReserved;
  SHORT    sStyle;
  WORD     wKerning;
  BYTE     bUnderlineType;
  BYTE     bAnimation;
  BYTE     bRevAuthor;
  BYTE     bUnderlineColor;
};

Herança

A estrutura CHARFORMAT2A implementa _charformat.

Membros

wWeight

Tipo: WORD

Peso da fonte. Esse membro é o mesmo que o membro lfWeight da estrutura LOGFONT. Para usar esse membro, defina o sinalizador CFM_WEIGHT no membro dwMask .

sSpacing

Tipo: SHORT

Espaço horizontal entre letras, em twips. Esse valor não tem efeito sobre o texto exibido por um controle de edição avançada; ele está incluído para compatibilidade com interfaces TOM do Windows. Para usar esse membro, defina o sinalizador CFM_SPACING no membro dwMask .

crBackColor

Tipo: COLORREF

Cor da tela de fundo. Para usar esse membro, defina o sinalizador CFM_BACKCOLOR no membro dwMask . Esse membro será ignorado se o efeito de caractere CFE_AUTOBACKCOLOR for especificado. Para gerar um, use a macro.

lcid

Tipo: LCID

Um identificador de localidade de 32 bits que contém um identificador de idioma na palavra inferior e um identificador de classificação e um valor reservado na palavra superior. Esse membro não tem efeito sobre o texto exibido por um controle de edição avançada, mas verificadores ortográficos e gramaticais podem usá-lo para lidar com problemas dependentes de linguagem. Você pode usar a macro para criar um valor de LCID . Para usar esse membro, defina o sinalizador CFM_LCID no membro dwMask .

dwReserved

Tipo: DWORD

Reservado; o valor deve ser zero.

dwCookie

Tipo: DWORD

Cookie do cliente. Esse membro é opaco para um controle de edição avançada.

sStyle

Tipo: SHORT

Identificador de estilo de caractere. Esse valor não tem efeito sobre o texto exibido por um controle de edição avançada; ele está incluído para compatibilidade com interfaces WindowsTOM. Para usar esse membro, defina o sinalizador CFM_STYLE no membro dwMask . Para obter mais informações, consulte a documentação do TOM.

wKerning

Tipo: WORD

Valor do tamanho da fonte, acima do qual o caractere (yHeight). Esse valor não tem efeito sobre o texto exibido por um controle de edição avançada; ele está incluído para compatibilidade com interfaces TOM. Para usar esse membro, defina o sinalizador CFM_KERNING no membro dwMask.

bUnderlineType

Tipo: BYTE

Especifica o tipo de sublinhado. Para usar esse membro, defina o sinalizador CFM_UNDERLINETYPE no membro dwMask. Esse membro pode ser um dos seguintes valores.

bAnimation

Tipo: BYTE

Tipo de animação de texto. Esse valor não tem efeito sobre o texto exibido por um controle de edição avançada; ele está incluído para compatibilidade com interfaces TOM. Para usar esse membro, defina o sinalizador CFM_ANIMATION no membro dwMask .

bRevAuthor

Tipo: BYTE

Um índice que identifica o autor fazendo uma revisão. O controle de edição avançada usa cores de texto diferentes para cada índice de autor diferente. Para usar esse membro, defina o sinalizador CFM_REVAUTHOR no membro dwMask.

bUnderlineColor

Tipo: BYTE

Cor do sublinhado:

• UnderlineColor_Black = 0x00;
• UnderlineColor_Blue = 0x01;
• UnderlineColor_Aqua = 0x02;
• UnderlineColor_Lime = 0x03;
• UnderlineColor_Fuchsia = 0x04;
• UnderlineColor_Red = 0x05;
• UnderlineColor_Yellow = 0x06;
• UnderlineColor_White = 0x07;
• UnderlineColor_Navy = 0x08;
• UnderlineColor_Teal = 0x09;
• UnderlineColor_Green = 0x0A;
• UnderlineColor_Purple = 0x0B;
• UnderlineColor_Maroon = 0x0C;
• UnderlineColor_Olive = 0x0D;
• UnderlineColor_DkGray = 0x0E;
• UnderlineColor_LtGray = 0x0F;

Observações

Para desativar um atributo de formatação, defina o valor apropriado em dwMask, mas não defina o valor correspondente em dwEffects. Por exemplo, para desativar itálicos, defina CFM_ITALIC mas não defina CFE_ITALIC.

Requisitos

Consulte também

CHARFORMAT

COLORREF

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor

DO LOGFONT

RGB