estrutura CHARFORMAT2W (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 CHARFORMAT2W : _charformatw {
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 CHARFORMAT2W implementa _charformatw.
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 os verificadores ortográficos e gramaticais podem usá-lo para lidar com problemas dependentes de idioma. Você pode usar a macro para criar um valor LCID . Para usar esse membro, defina o sinalizador CFM_LCID no membro dwMask .
dwReserved
Tipo: DWORD
Reservados; o valor deve ser zero.
Tipo: DWORD
Reservados; o valor deve ser zero.
dwCookie
Tipo: DWORD
Cookie do cliente. Esse membro é opaco a 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 kern 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 valores a seguir.
| Valor | Significado |
|---|---|
|
A estrutura mapeia o sublinhado de bits CHARFORMAT para CHARFORMAT2 (ou seja, ele executa um tipo CHARFORMAT de sublinhado neste texto). |
|
Para a composição do IME, finja uma seleção. |
|
Texto sublinhado com uma única linha sólida. |
|
Texto sublinhado com traços. |
|
Texto sublinhado com uma linha tracejada e pontilhada. |
|
Texto sublinhado com uma linha pontilhada tracejada e dobrada. |
|
Texto sublinhado com uma linha pontilhada. Para versões anteriores ao Microsoft Rich Edit 3.0, o texto é exibido com um sublinhado sólido. |
|
Texto sublinhado com uma linha dupla. O controle de edição avançada exibe o texto com um sublinhado sólido. |
|
Exibir como CFU_UNDERLINEWAVE. |
|
Exibir como CFU_UNDERLINE. |
|
Exibir como CFU_UNDERLINEWAVE. |
|
Exibir como CFU_UNDERLINEDASH. |
|
Sem sublinhado. Esse é o padrão. |
|
Exibir como CFU_UNDERLINE. |
|
Exibir como CFU_UNDERLINEDASH. |
|
Exibir como CFU_UNDERLINEDASHDOT. |
|
Exibir como CFU_UNDERLINEDASHDOT. |
|
Exibir como CFU_UNDERLINEDOT. |
|
Exibir como CFU_UNDERLINEDASH. |
|
RichEdit 4.1 e posterior: texto sublinhado com uma linha ondulada. |
|
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;
Comentários
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álico, defina CFM_ITALIC mas não defina CFE_ITALIC.
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | richedit.h |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de