estructura de PARAFORMAT2 (Rich Edit 2.0)
Contiene información sobre los atributos de formato de párrafo en un control de edición enriquecido. PARAFORMAT2 es una extensión de Microsoft Rich Edit 2.0 de la estructura PARAFORMAT . Microsoft Rich Edit 2.0 le permite usar cualquier estructura con los mensajes EM_GETPARAFORMAT y EM_SETPARAFORMAT .
Sintaxis
typedef struct _paraformat2 {
UINT cbSize;
DWORD dwMask;
WORD wNumbering;
union {
WORD wReserved;
WORD wEffects;
};
LONG dxStartIndent;
LONG dxRightIndent;
LONG dxOffset;
WORD wAlignment;
SHORT cTabCount;
LONG rgxTabs[MAX_TAB_STOPS];
LONG dySpaceBefore;
LONG dySpaceAfter;
LONG dyLineSpacing;
SHORT sStyle;
BYTE bLineSpacingRule;
BYTE bOutlineLevel;
WORD wShadingWeight;
WORD wShadingStyle;
WORD wNumberingStart;
WORD wNumberingStyle;
WORD wNumberingTab;
WORD wBorderSpace;
WORD wBorderWidth;
WORD wBorders;
} PARAFORMAT2;
Miembros
cbSize
Tipo: UINT
Tamaño de la estructura, en bytes. Antes de pasar esta estructura a un control de edición enriquecido, establezca cbSize en el tamaño de la estructura PARAFORMAT o PARAFORMAT2 . Si cbSize es igual al tamaño de una estructura PARAFORMAT , el control solo usa los miembros PARAFORMAT .
dwMask
Tipo: DWORD
Miembros de la estructura PARAFORMAT2 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 wEffects .
Establezca los valores siguientes para indicar los miembros de estructura válidos.
Establezca los valores siguientes para indicar los atributos válidos del miembro wEffects .
wNumbering
Tipo: WORD
Opciones usadas para párrafos numerados o con viñetas. Para usar este miembro, establezca la marca PFM_NUMBERING en el miembro dwMask .
Este miembro puede ser uno de los siguientes valores.
| Valor | Significado |
|---|---|
|
No hay numeración ni viñetas de párrafo. |
|
Inserte una viñeta al principio de cada párrafo seleccionado. |
Las versiones de Edición enriquecidas anteriores a la versión 3.0 no muestran números de párrafo. Sin embargo, para la compatibilidad con las interfaces del Modelo de objetos de texto de Microsoft (TOM), wNumbering puede especificar uno de los siguientes valores. (El control de edición enriquecido almacena el valor, pero no lo usa para mostrar el texto).
wReserved
wEffects
Tipo: WORD
Este miembro también se conoce como wReserved para Microsoft Rich Edit 1.0 porque estaba reservado.
Edición enriquecida 1.0: Reservados; el valor debe ser cero.
Rich Edit 2.0: Conjunto de marcas de bits que especifican efectos de párrafo. Estas marcas solo se incluyen por compatibilidad con interfaces TOM; el control de edición enriquecida almacena el valor, pero no lo usa para mostrar el texto.
Este miembro puede ser una combinación de los valores siguientes.
dxStartIndent
Tipo: LONG
Sangría de la primera línea del párrafo, en twips. La sangría de las líneas posteriores depende del miembro dxOffset . Para usar el miembro dxStartIndent , establezca la marca PFM_STARTINDENT o PFM_OFFSETINDENT en el miembro dwMask . Si va a establecer la sangría, use la marca PFM_STARTINDENT para especificar una sangría absoluta desde el margen izquierdo; o use la marca PFM_OFFSETINDENT para especificar una sangría relativa a la sangría actual del párrafo. Use cualquiera de las marcas para recuperar la sangría actual.
dxRightIndent
Tipo: LONG
Sangría del lado derecho del párrafo, en relación con el margen derecho, en twips. Para usar este miembro, establezca la marca PFM_RIGHTINDENT en el miembro dwMask .
dxOffset
Tipo: LONG
Sangría de la segunda y las líneas posteriores, relativas a la sangría de la primera línea, en twips. Se aplica sangría a la primera línea si este miembro es negativo o se anula si este miembro es positivo. Para usar este miembro, establezca la marca PFM_OFFSET en el miembro dwMask .
wAlignment
Tipo: WORD
Alineación del párrafo. Para usar este miembro, establezca la marca PFM_ALIGNMENT en el miembro dwMask . Este miembro puede ser uno de los valores siguientes.
cTabCount
Tipo: SHORT
Número de tabulaciones definidas en la matriz rgxTabs .
rgxTabs[MAX_TAB_STOPS]
Tipo: LONG
Matriz de posiciones de tabulación absolutas. Cada elemento de la matriz especifica información sobre una tabulación. Los 24 bits de orden bajo especifican el desplazamiento absoluto, en twips. Para usar este miembro, establezca la marca PFM_TABSTOPS en el miembro dwMask .
Rich Edit 2.0: Para la compatibilidad con las interfaces TOM, puede usar los ocho bits de orden superior para almacenar información adicional sobre cada tabulación.
Los bits 24-27 pueden especificar uno de los siguientes valores para indicar la alineación de tabulación. Estos bits no afectan a la presentación de control de edición enriquecida para versiones anteriores a Microsoft Rich Edit 3.0.
| Valor | Significado |
|---|---|
|
Pestaña Normal |
|
Pestaña Centro |
|
Pestaña alineada a la derecha |
|
Tabulación decimal |
|
pestaña Word barra (barra vertical) |
Los bits 28-31 pueden especificar uno de los siguientes valores para indicar el tipo de guía de tabulación. Estos bits no afectan a la presentación del control de edición enriquecida.
| Valor | Significado |
|---|---|
|
Sin líder |
|
Líder punteado |
|
Líder discontinuo |
|
Líder subrayado |
|
Guía de línea gruesa |
|
Guía de línea doble |
dySpaceBefore
Tipo: LONG
Tamaño del espaciado por encima del párrafo, en twips. Para usar este miembro, establezca la marca PFM_SPACEBEFORE en el miembro dwMask . El valor debe ser mayor o igual que cero.
dySpaceAfter
Tipo: LONG
Especifica el tamaño del espaciado por debajo del párrafo, en twips. Para usar este miembro, establezca la marca PFM_SPACEAFTER en el miembro dwMask . El valor debe ser mayor o igual que cero.
dyLineSpacing
Tipo: LONG
Espaciado entre líneas. Para obtener una descripción de cómo se interpreta este valor, consulte el miembro bLineSpacingRule . Para usar este miembro, establezca la marca PFM_LINESPACING en el miembro dwMask .
sStyle
Tipo: SHORT
Estilo de texto. Para usar este miembro, establezca la marca PFM_STYLE en el miembro dwMask . Este miembro solo se incluye por compatibilidad con interfaces TOM y Word; el control de edición enriquecido almacena el valor, pero no lo usa para mostrar el texto.
bLineSpacingRule
Tipo: BYTE
Tipo de interlineado. Para usar este miembro, establezca la marca PFM_LINESPACING en el miembro dwMask . Este miembro puede ser uno de los valores siguientes.
bOutlineLevel
Tipo: BYTE
Reservados; debe ser cero.
wShadingWeight
Tipo: WORD
Porcentaje de color de primer plano usado en sombreado. El miembro wShadingStyle especifica los colores de sombreado de fondo y de primer plano. Un valor de 5 indica un color de sombreado que consta del 5 por ciento del color de primer plano y del 95 por ciento de color de fondo. Para usar estos miembros, establezca la marca PFM_SHADING en el miembro dwMask . Este miembro solo se incluye por compatibilidad con Word; el control de edición enriquecido almacena el valor, pero no lo usa para mostrar el texto.
wShadingStyle
Tipo: WORD
Estilo y colores usados para sombreado de fondo. Los bits de 0 a 3 contienen el estilo de sombreado, los bits de 4 a 7 contienen el índice de color de primer plano y los bits de 8 a 11 contienen el índice de color de fondo. Para usar este miembro, establezca la marca PFM_SHADING en el miembro dwMask . Este miembro solo se incluye por compatibilidad con Word; el control de edición enriquecido almacena el valor, pero no lo usa para mostrar el texto.
El estilo de sombreado puede ser uno de los valores siguientes.
Los índices de color de primer plano y de fondo pueden ser uno de los valores siguientes.
wNumberingStart
Tipo: WORD
Número inicial o valor Unicode usado para párrafos numerados. Use este miembro junto con el miembro wNumbering . Este miembro solo se incluye por compatibilidad con interfaces TOM; el control de edición enriquecida almacena el valor, pero no lo usa para mostrar el texto o las viñetas. Para usar este miembro, establezca la marca PFM_NUMBERINGSTART en el miembro dwMask .
wNumberingStyle
Tipo: WORD
Estilo de numeración usado con párrafos numerados. Use este miembro junto con el miembro wNumbering . Este miembro solo se incluye por compatibilidad con interfaces TOM; El control de edición enriquecida almacena el valor, pero las versiones de edición enriquecidas anteriores a la 3.0 no la usan para mostrar el texto o las viñetas. Para usar este miembro, establezca la marca PFM_NUMBERINGSTYLE en el miembro dwMask . Este miembro puede ser uno de los valores siguientes.
wNumberingTab
Tipo: WORD
Espacio mínimo entre un número de párrafo y el texto del párrafo, en twips. Use este miembro junto con el miembro wNumbering . El miembro wNumberingTab se incluye por compatibilidad con interfaces TOM; anterior a Microsoft Rich Edit 3.0, el control de edición enriquecido almacena el valor, pero no lo usa para mostrar texto. Para usar este miembro, establezca la marca PFM_NUMBERINGTAB en el miembro dwMask .
wBorderSpace
Tipo: WORD
Espacio entre el borde y el texto del párrafo, en twips. El miembro wBorderSpace se incluye por compatibilidad con Word; el control de edición enriquecido almacena los valores, pero no los usa para mostrar texto. Para usar este miembro, establezca la marca PFM_BORDER en el miembro dwMask .
wBorderWidth
Tipo: WORD
Ancho del borde, en twips. Para usar este miembro, establezca la marca PFM_BORDER en el miembro dwMask .
wBorders
Tipo: WORD
Ubicación del borde, estilo y color. Los bits 0 a 7 especifican las ubicaciones de borde, los bits 8 a 11 especifican el estilo de borde y los bits de 12 a 15 especifican el índice de color del borde. Para usar este miembro, establezca la marca PFM_BORDER en el miembro dwMask .
Especifique las ubicaciones de borde mediante una combinación de los valores siguientes en bits 0 a 7.
Especifique el estilo de borde con uno de los valores siguientes para los bits 8 a 11.
Especifique el color del borde con uno de los valores siguientes para los bits de 12 a 15. Este valor se omite si se establece el bit de color automático (bit 6).
Requisitos
| 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