estructura de CHARFORMAT2W (Rich Edit 2.0)
Contiene información sobre el formato de caracteres en un control de edición enriquecido. CHARFORMAT2 es una extensión de Microsoft Rich Edit 2.0 de la estructura CHARFORMAT . Microsoft Rich Edit 2.0 permite usar cualquiera de las estructuras con los mensajes EM_GETCHARFORMAT y EM_SETCHARFORMAT .
Sintaxis
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;
Miembros
cbSize
Tipo: UINT
Especifica el tamaño, en bytes, de la estructura. Antes de pasar esta estructura a un control de edición enriquecido, establezca cbSize en el tamaño de CHARFORMAT o CHARFORMAT2 estructura. Si cbSize es igual al tamaño de una estructura CHARFORMAT , el control solo usa los miembros CHARFORMAT .
dwMask
Tipo: DWORD
Especifica las partes de la estructura de CHARFORMAT2 que contienen información válida. El miembro dwMask puede ser una combinación de los valores de dos conjuntos de marcas de bits. Un conjunto indica los miembros de la estructura que son válidos. Otro conjunto indica los atributos válidos en el miembro dwEffects .
Establezca los valores siguientes para indicar los atributos válidos del miembro dwEffects .
Establezca los valores siguientes para indicar los miembros de estructura válidos.
dwEffects
Tipo: DWORD
Conjunto de marcas de bits que especifican efectos de caracteres. Algunas de las marcas solo se incluyen por motivos de compatibilidad con las interfaces del Modelo de objetos de texto de Microsoft (TOM); El control de edición enriquecida almacena el valor, pero no lo usa para mostrar texto.
Este miembro puede ser una combinación de los valores siguientes.
| Valor | Significado |
|---|---|
|
Los caracteres son letras mayúsculas. El valor no afecta a la forma en que el control muestra el texto. Este valor solo se aplica a las versiones anteriores a Microsoft Rich Edit 3.0. |
|
El color de fondo es el valor devuelto de GetSysColor(COLOR_WINDOW). Si se establece esta marca, se omite el miembro crBackColor . |
|
El color del texto es el valor devuelto de GetSysColor(COLOR_WINDOWTEXT). Si se establece esta marca, se omite el miembro crTextColor . |
|
Los caracteres están en negrita. |
|
Los caracteres se muestran con una sombra que se desplaza por 3/4 puntos o un píxel, lo que sea mayor. |
|
Los caracteres están en relieve. El valor no afecta al modo en que el control muestra el texto. |
|
Los caracteres son miembros menos comunes de un script. Una fuente que admita un script debe comprobar si tiene glifos para estos caracteres. |
|
El control de edición enriquecido elige fuente porque la fuente activa no admite los caracteres. Este proceso se denomina enlace de fuentes. |
|
Para Microsoft Rich Edit 3.0 y versiones posteriores, no se muestran los caracteres. |
|
Los caracteres se muestran como caracteres impresos. El valor no afecta al modo en que el control muestra el texto. |
|
Los caracteres son cursiva. |
|
Un control de edición enriquecido puede enviar EN_LINK códigos de notificación cuando recibe mensajes del mouse mientras el puntero del mouse está sobre texto con el efecto CFE_LINK . |
|
Los caracteres forman parte de un vínculo de nombre descriptivo. |
|
Los caracteres están en una zona matemática. |
|
Los caracteres no participan en una compilación matemática. Por ejemplo, cuando se aplica a /, no se usará / para generar una fracción. |
|
Los caracteres se muestran como texto normal dentro de una zona matemática. |
|
Los caracteres se muestran como caracteres descritos. El valor no afecta al modo en que el control muestra el texto. |
|
Los caracteres están protegidos; un intento de modificarlos provocará un código de notificación EN_PROTECTED . |
|
Los caracteres se marcan como revisados. |
|
Los caracteres se muestran como caracteres sombreados. El valor no afecta al modo en que el control muestra el texto. |
|
Los caracteres están en minúsculas. El valor no afecta al modo en que el control muestra el texto. |
|
Los caracteres se golpean. |
|
Los caracteres son subíndice. Los valores de CFE_SUPERSCRIPT y CFE_SUBSCRIPT son mutuamente excluyentes. Para ambos valores, el control calcula automáticamente un desplazamiento y un tamaño de fuente más pequeño. Como alternativa, puede usar los miembros yHeight e yOffset para especificar explícitamente el tamaño y el desplazamiento de fuente para los caracteres de subíndice y superíndice. |
|
Los caracteres son superíndice. |
|
Los caracteres están subrayados. |
yHeight
Tipo: LONG
Especifica el alto del carácter, en twips (1/1440 de pulgada o 1/20 del punto de una impresora). Para usar este miembro, establezca la marca CFM_SIZE en el miembro dwMask .
yOffset
Tipo: LONG
Desplazamiento de caracteres desde la línea base, en twips. Si el valor de este miembro es positivo, el carácter es un superíndice; si el valor es negativo, el carácter es un subíndice. Para usar este miembro, establezca la marca CFM_OFFSET en el miembro dwMask .
crTextColor
Tipo: COLORREF
Color del texto. Para usar este miembro, establezca la marca CFM_COLOR en el miembro dwMask . Este miembro se omite si se especifica el efecto de CFE_AUTOCOLOR carácter. Para generar un COLORREF, use la macro RGB .
bCharSet
Tipo: BYTE
Valor del juego de caracteres. Puede ser uno de los valores especificados para el miembro lfCharSet de la estructura LOGFONT . Para usar este miembro, establezca la marca CFM_CHARSET en el miembro dwMask .
bPitchAndFamily
Tipo: BYTE
Especifica la familia de fuentes y el tono. Este miembro es el mismo que el miembro lfPitchAndFamily de la estructura LOGFONT .
szFaceName[LF_FACESIZE]
Tipo: TCHAR[LF_FACESIZE]
Matriz de caracteres terminada en null que especifica el nombre de fuente. Para usar este miembro, establezca la marca CFM_FACE en el miembro dwMask .
wWeight
Tipo: WORD
Peso de fuente. Este miembro es el mismo que el miembro lfWeight de la estructura LOGFONT . Para usar este miembro, establezca la marca CFM_WEIGHT en el miembro dwMask .
sSpacing
Tipo: SHORT
Espacio horizontal entre letras, en twips. Este valor no tiene ningún efecto en el texto mostrado por un control de edición enriquecido; se incluye para la compatibilidad con las interfaces tom de Windows. Para usar este miembro, establezca la marca CFM_SPACING en el miembro dwMask .
crBackColor
Tipo: COLORREF
Color de fondo. Para usar este miembro, establezca la marca CFM_BACKCOLOR en el miembro dwMask . Este miembro se omite si se especifica el efecto de CFE_AUTOBACKCOLOR carácter. Para generar un , use la macro .
lcid
Tipo: LCID
Identificador de configuración regional de 32 bits que contiene un identificador de idioma en la palabra inferior y un identificador de ordenación y un valor reservado en la palabra superior. Este miembro no tiene ningún efecto en el texto mostrado por un control de edición enriquecido, pero los correctores ortográficos y gramaticales pueden usarlo para tratar con problemas dependientes del idioma. Puede usar la macro para crear un valor LCID . Para usar este miembro, establezca la marca CFM_LCID en el miembro dwMask .
dwReserved
Tipo: DWORD
Reservados; el valor debe ser cero.
dwCookie
Tipo: DWORD
Cookie de cliente. Este miembro es opaco para un control de edición enriquecido.
sStyle
Tipo: SHORT
Identificador de estilo de caracteres. Este valor no tiene ningún efecto en el texto mostrado por un control de edición enriquecido; se incluye por compatibilidad con interfaces WindowsTOM. Para usar este miembro, establezca la marca CFM_STYLE en el miembro dwMask . Para obtener más información, consulte la documentación de TOM.
wKerning
Tipo: WORD
Valor del tamaño de fuente, por encima del cual se va a kern el carácter (yHeight). Este valor no tiene ningún efecto en el texto mostrado por un control de edición enriquecido; se incluye por motivos de compatibilidad con interfaces TOM. Para usar este miembro, establezca la marca CFM_KERNING en el miembro dwMask .
bUnderlineType
Tipo: BYTE
Especifica el tipo de subrayado. Para usar este miembro, establezca la marca CFM_UNDERLINETYPE en el miembro dwMask . Este miembro puede ser uno de los siguientes valores.
| Valor | Significado |
|---|---|
|
La estructura asigna el subrayado de bits CHARFORMAT a CHARFORMAT2( es decir, realiza un tipo CHARFORMAT de subrayado en este texto). |
|
Para la composición IME, finga una selección. |
|
Texto subrayado con una sola línea sólida. |
|
Texto subrayado con guiones. |
|
Texto subrayado con una línea discontinua y punteada. |
|
Texto subrayado con una línea de puntos discontinua y duplicada. |
|
Texto subrayado con una línea de puntos. Para las versiones anteriores a Microsoft Rich Edit 3.0, el texto se muestra con un subrayado sólido. |
|
Texto subrayado con una línea doble. El control de edición enriquecido muestra el texto con un subrayado sólido. |
|
Mostrar como CFU_UNDERLINEWAVE. |
|
Se muestra como CFU_UNDERLINE. |
|
Mostrar como CFU_UNDERLINEWAVE. |
|
Mostrar como CFU_UNDERLINEDASH. |
|
Sin subrayado. Este es el valor predeterminado. |
|
Se muestra como CFU_UNDERLINE. |
|
Mostrar como CFU_UNDERLINEDASH. |
|
Mostrar como CFU_UNDERLINEDASHDOT. |
|
Mostrar como CFU_UNDERLINEDASHDOT. |
|
Se muestra como CFU_UNDERLINEDOT. |
|
Mostrar como CFU_UNDERLINEDASH. |
|
RichEdit 4.1 y versiones posteriores: texto subrayado con una línea ondulada. |
|
RichEdit 4.1 y versiones posteriores: subrayado solo palabras. El control de edición enriquecido muestra el texto con un subrayado sólido. |
bAnimation
Tipo: BYTE
Tipo de animación de texto. Este valor no tiene ningún efecto en el texto mostrado por un control de edición enriquecido; se incluye por motivos de compatibilidad con interfaces TOM. Para usar este miembro, establezca la marca CFM_ANIMATION en el miembro dwMask .
bRevAuthor
Tipo: BYTE
Índice que identifica al autor que realiza una revisión. El control de edición enriquecida usa colores de texto diferentes para cada índice de autor diferente. Para usar este miembro, establezca la marca CFM_REVAUTHOR en el miembro dwMask .
bUnderlineColor
Tipo: BYTE
Color de subrayado:
- 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;
Comentarios
Para desactivar un atributo de formato, establezca el valor adecuado en dwMask , pero no establezca el valor correspondiente en dwEffects. Por ejemplo, para desactivar cursiva, establezca CFM_ITALIC pero no establezca CFE_ITALIC.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | richedit.h |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de