estrutura CHARFORMAT2W (Edição Avançada 2.0)
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
typedef struct _charformat2w {
UINT cbSize;
DWORD dwMask;
DWORD dwEffects;
LONG yHeight;
LONG yOffset;
COLORREF crTextColor;
BYTE bCharSet;
BYTE bPitchAndFamily;
WCHAR szFaceName[LF_FACESIZE];
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;
} CHARFORMAT2W;
Membros
cbSize
Tipo: UINT
Especifica o tamanho, em bytes, da estrutura . Antes de passar essa estrutura para um controle de edição avançada, defina cbSize como o tamanho da estrutura CHARFORMAT ou CHARFORMAT2 . Se cbSize for igual ao tamanho de uma estrutura CHARFORMAT , o controle usará apenas os membros CHARFORMAT .
dwMask
Tipo: DWORD
Especifica as partes da estrutura CHARFORMAT2 que contêm informações válidas. O membro dwMask pode ser uma combinação dos valores de dois conjuntos de sinalizadores de bits. Um conjunto indica os membros da estrutura que são válidos. Outro conjunto indica os atributos válidos no membro dwEffects .
Defina os valores a seguir para indicar os atributos válidos do membro dwEffects .
Defina os valores a seguir para indicar os membros válidos da estrutura.
dwEffects
Tipo: DWORD
Um conjunto de sinalizadores de bits que especificam efeitos de caractere. Alguns dos sinalizadores são incluídos apenas para compatibilidade com interfaces TOM ( Modelo de Objeto de Texto ) da Microsoft; o controle de edição avançada armazena o valor, mas não o usa para exibir texto.
Esse membro pode ser uma combinação dos valores a seguir.
| Valor | Significado |
|---|---|
|
Os caracteres são letras maiúsculas. O valor não afeta a maneira como o controle exibe o texto. Esse valor se aplica apenas a versões anteriores ao Microsoft Rich Edit 3.0. |
|
A cor da tela de fundo é o valor retornado de GetSysColor(COLOR_WINDOW). Se esse sinalizador estiver definido, o membro crBackColor será ignorado. |
|
A cor do texto é o valor retornado de GetSysColor(COLOR_WINDOWTEXT). Se esse sinalizador estiver definido, o membro crTextColor será ignorado. |
|
Os caracteres são ousados. |
|
Os caracteres são exibidos com uma sombra que é deslocada por 3/4 ponto ou um pixel, o que for maior. |
|
Os caracteres são remendados. O valor não afeta como o controle exibe o texto. |
|
Os caracteres são membros menos comuns de um script. Uma fonte compatível com um script deve marcar se tiver glifos para esses caracteres. |
|
A fonte é escolhida pelo controle de edição avançada porque a fonte ativa não dá suporte aos caracteres. Esse processo é chamado de associação de fonte. |
|
Para o Microsoft Rich Edit 3.0 e posterior, os caracteres não são exibidos. |
|
Os caracteres são exibidos como caracteres impressos. O valor não afeta como o controle exibe o texto. |
|
Os caracteres são itálicos. |
|
Um controle de edição avançada pode enviar códigos de notificação EN_LINK quando recebe mensagens do mouse enquanto o ponteiro do mouse está sobre o texto com o efeito CFE_LINK . |
|
Os caracteres fazem parte de um link de nome amigável. |
|
Os caracteres estão em uma zona matemática. |
|
Os caracteres não participam de um acúmulo de matemática. Por exemplo, quando aplicado a um /, o / não será usado para criar uma fração. |
|
Os caracteres são exibidos como texto comum dentro de uma zona matemática. |
|
Os caracteres são exibidos como caracteres descritos. O valor não afeta como o controle exibe o texto. |
|
Os caracteres são protegidos; uma tentativa de modificá-los causará um código de notificação EN_PROTECTED. |
|
Os caracteres são marcados como revisados. |
|
Os caracteres são exibidos como caracteres sombreados. O valor não afeta como o controle exibe o texto. |
|
Os caracteres estão em letras maiúsculas pequenas. O valor não afeta como o controle exibe o texto. |
|
Os caracteres são eliminados. |
|
Os caracteres são subscritos. Os valores CFE_SUPERSCRIPT e CFE_SUBSCRIPT são mutuamente exclusivos. Para ambos os valores, o controle calcula automaticamente 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 o deslocamento para caracteres subscritos e sobrescritos. |
|
Os caracteres são sobrescritos. |
|
Os caracteres são sublinhados. |
yHeight
Tipo: LONG
Especifica a altura do caractere, em twips (1/1440 de polegada ou 1/20 do ponto de uma impressora). Para usar esse membro, defina o sinalizador CFM_SIZE no membro dwMask .
yOffset
Tipo: LONG
Deslocamento de caractere da linha de base, em twips. Se o valor desse membro for positivo, o caractere será um sobrescrito; se o valor for negativo, o caractere será um subscrito. Para usar esse membro, defina o sinalizador CFM_OFFSET no membro dwMask .
crTextColor
Tipo: COLORREF
Cor de texto. Para usar esse membro, defina o sinalizador CFM_COLOR no membro dwMask . Esse membro será ignorado se o efeito de caractere CFE_AUTOCOLOR for especificado. Para gerar um COLORREF, use a macro RGB .
bCharSet
Tipo: BYTE
Valor do conjunto de caracteres. Pode ser um dos valores especificados para o membro lfCharSet da estrutura LOGFONT . Para usar esse membro, defina o sinalizador CFM_CHARSET no membro dwMask .
bPitchAndFamily
Tipo: BYTE
Especifica a família de fontes e o pitch. Esse membro é o mesmo que o membro lfPitchAndFamily da estrutura LOGFONT .
szFaceName[LF_FACESIZE]
Tipo: TCHAR[LF_FACESIZE]
Uma matriz de caracteres terminada em nulo especificando o nome da fonte. Para usar esse membro, defina o sinalizador CFM_FACE no membro dwMask .
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.
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.
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