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.

Valor	Significado
CFU_CF1UNDERLINE	A estrutura mapeia sublinhado de bits doCHARFORMAT para CHARFORMAT2, (ou seja, executa um tipo CHARFORMAT neste texto).
CFU_INVERT	Para a composição do IME, falsija uma seleção.
CFU_UNDERLINE	Texto sublinhado com uma única linha sólida.
CFU_UNDERLINEDASH	Texto sublinhado com traços.
CFU_UNDERLINEDASHDOT	Texto sublinhado com uma linha tracejada e pontilhada.
CFU_UNDERLINEDASHDOTDOT	Texto sublinhado com uma linha pontilhada tracejada e dobrada.
CFU_UNDERLINEDOTTED	Texto sublinhado com uma linha pontilhada. Para versões anteriores ao Microsoft Rich Edit 3.0, o texto é exibido com um sublinhado sólido.
CFU_UNDERLINEDOUBLE	Texto sublinhado com uma linha dupla. O controle de edição avançada exibe o texto com um sublinhado sólido.
CFU_UNDERLINEDOUBLEWAVE	Exibir como CFU_UNDERLINEWAVE.
CFU_UNDERLINEHAIRLINE	Exibir como CFU_UNDERLINE.
CFU_UNDERLINEHEAVYWAVE	Exibir como CFU_UNDERLINEWAVE.
CFU_UNDERLINELONGDASH	Exibir como CFU_UNDERLINEDASH.
CFU_UNDERLINENONE	Sem sublinhado. Esse é o padrão.
CFU_UNDERLINETHICK	Exibir como CFU_UNDERLINE.
CFU_UNDERLINETHICKDASH	Exibir como CFU_UNDERLINEDASH.
CFU_UNDERLINETHICKDASHDOT	Exibir como CFU_UNDERLINEDASHDOT.
CFU_UNDERLINETHICKDASHDOTDOT	Exibir como CFU_UNDERLINEDASHDOT.
CFU_UNDERLINETHICKDOTTED	Exibir como CFU_UNDERLINEDOT.
CFU_UNDERLINETHICKLONGDASH	Exibir como CFU_UNDERLINEDASH.
CFU_UNDERLINEWAVE	RichEdit 4.1 e posterior: texto sublinhado com uma linha ondulada.
CFU_UNDERLINEWORD	RichEdit 4.1 e posterior: sublinhar somente palavras. O controle de edição avançada exibe o texto com um sublinhado sólido.

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.

Nota

O cabeçalho richedit.h define CHARFORMAT2 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	richedit.h

Consulte também

CHARFORMAT

COLORREF

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor

DO LOGFONT

RGB