estrutura CHARFORMAT2A (Rich Edit 2.0)
Contém informações sobre a formatação de caracteres em um controle de edição avançada.
Sintaxe
typedef struct _charformat2a {
UINT cbSize;
DWORD dwMask;
DWORD dwEffects;
LONG yHeight;
LONG yOffset;
COLORREF crTextColor;
BYTE bCharSet;
BYTE bPitchAndFamily;
char 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;
} CHARFORMAT2A;
Membros
cbSize
Especifica o tamanho, em bytes, da estrutura. Antes de passar essa estrutura para um controle de edição avançada, defina
dwMask
Tipo: DWORD
Especifica as partes da estrutura de 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 válidos. Outro conjunto indica os atributos válidos no membro
Defina os valores a seguir para indicar os atributos válidos do membro
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
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, crBackColor membro será ignorado. |
|
A cor do texto é o valor retornado de GetSysColor(COLOR_WINDOWTEXT). Se esse sinalizador estiver definido, o membro crTextColor |
|
Os caracteres são em negrito. |
|
Os caracteres são exibidos com uma sombra que é deslocada por 3/4 pontos ou um pixel, o que for maior. |
|
Os caracteres são rebomados. 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 verificar se ele tem 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á-las 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
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
yOffset
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
Cor do texto. Para usar esse membro, defina o sinalizador
bCharSet
Valor do conjunto de caracteres. Pode ser um dos valores especificados para o
bPitchAndFamily
Especifica a família de fontes e o pitch. Esse membro é o mesmo que o membro lfPitchAndFamily
szFaceName[LF_FACESIZE]
Uma matriz de caracteres terminada em nulo especificando o nome da fonte. Para usar esse membro, defina o sinalizador
wWeight
Peso da fonte. Esse membro é o mesmo que o membro
sSpacing
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
crBackColor
Cor da tela de fundo. Para usar esse membro, defina o sinalizador
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
dwReserved
Tipo: DWORD
Reservado; o valor deve ser zero.
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
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
wKerning
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
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 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
bRevAuthor
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
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
| 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