estructura PARAFORMAT2 (Rich Edit 2.0)

Artículo
08/15/2024

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 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 de

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 de PARAFORMAT o PARAFORMAT2. Si cbSize es igual al tamaño de una estructura de PARAFORMAT, el control usa solo los miembros de PARAFORMAT.

dwMask

Tipo: DWORD de

Los 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 del miembro wEffects.

Establezca los valores siguientes para indicar los miembros de estructura válidos.

Valor	Significado
PFM_ALIGNMENT	El miembro wAlignment es válido.
PFM_ALL	Combinación de los siguientes valores: PFM_STARTINDENT, PFM_RIGHTINDENT, PFM_OFFSET, PFM_ALIGNMENT, PFM_TABSTOPS, PFM_NUMBERING, PFM_OFFSETINDENT y PFM_RTLPARA.
PFM_ALL2	Combinación de los siguientes valores: PFM_ALL, PFM_EFFECTS, PFM_SPACEBEFORE, PFM_SPACEAFTER, PFM_LINESPACING, PFM_STYLE, PFM_SHADING, PFM_BORDER, PFM_NUMBERINGTAB, PFM_NUMBERINGSTART y PFM_NUMBERINGSTYLE.
PFM_BORDER	Los wBorderSpace, wBorderWidthy miembros wBorders son válidos.
PFM_LINESPACING	Los dyLineSpacing y miembros bLineSpacingRule son válidos.
PFM_NUMBERING	El miembro wNumbering es válido.
PFM_NUMBERINGSTART	El miembro wNumberingStart es válido.
PFM_NUMBERINGSTYLE	El miembro wNumberingStyle es válido.
PFM_NUMBERINGTAB	El miembro wNumberingTab es válido.
PFM_OFFSET	El miembro dxOffset es válido.
PFM_OFFSETINDENT	El miembro dxStartIndent es válido. Si establece la sangría, dxStartIndent especifica la cantidad de sangría relativa a la sangría actual.
PFM_OUTLINELEVEL	El miembro bOutlineLevel es válido.
PFM_RIGHTINDENT	El miembro dxRightIndent es válido.
PFM_SHADING	Los wShadingWeight y wShadingStyle son válidos.
PFM_SPACEAFTER	El miembro dySpaceAfter es válido.
PFM_SPACEBEFORE	El miembro dySpaceBefore es válido.
PFM_STARTINDENT	El miembro dxStartIndent es válido y especifica la sangría desde el margen izquierdo. Si se especifican PFM_STARTINDENT y PFM_OFFSETINDENT, PFM_STARTINDENT tiene prioridad.
PFM_STYLE	El miembro sStyle es válido.
PFM_TABSTOPS	Los cTabCount de y miembros de rgxTabs son válidos.

Establezca los siguientes valores para indicar los atributos válidos del miembro wEffects.

Valor	Significado
PFM_DONOTHYPHEN	El valor de PFE_DONOTHYPHEN es válido.
PFM_EFFECTS	Combinación de los siguientes valores: PFM_RTLPARA, PFM_KEEP, PFM_KEEPNEXT, PFM_TABLE, PFM_PAGEBREAKBEFORE, PFM_NOLINENUMBER, PFM_NOWIDOWCONTROL, PFM_DONOTHYPHEN, PFM_SIDEBYSIDE y PFM_TABLEROWDELIMITER.
PFM_KEEP	El valor de PFE_KEEP es válido.
PFM_KEEPNEXT	El valor PFE_KEEPNEXT es válido.
PFM_NOLINENUMBER	El valor de PFE_NOLINENUMBER es válido.
PFM_NOWIDOWCONTROL	El valor PFE_NOWIDOWCONTROL es válido.
PFM_PAGEBREAKBEFORE	El valor de PFE_PAGEBREAKBEFORE es válido.
PFM_RTLPARA	El valor de PFE_RTLPARA es válido.
PFM_SIDEBYSIDE	El valor de PFE_SIDEBYSIDE es válido.
PFM_TABLE	El valor de PFE_TABLE es válido.
PFM_TABLEROWDELIMITER	El valor de PFE_TABLEROWDELIMITER es válido.

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
cero	No hay numeración ni viñetas de párrafo.
PFN_BULLET	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 (TOM) del modelo de objetos de texto de Microsoft , 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).

Valor	Significado
PFN_ARABIC	Use números arábigos (0, 1, 2, etc.).
PFN_LCLETTER	Use letras minúsculas (a, b, c, etc.).
PFN_LCROMAN	Use letras romanas minúsculas (i, ii, iii, etc.).
PFN_UCLETTER	Use letras mayúsculas (A, B, C, etc.).
PFN_UCROMAN	Use letras romanas mayúsculas (I, II, III, etc.).
7	Usa una secuencia de caracteres que comienza con el carácter Unicode especificado por el miembro wNumberingStart.

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: reservado; el valor debe ser cero.

Rich Edit 2.0: Un 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 enriquecido almacena el valor, pero no lo usa para mostrar el texto.

Este miembro puede ser una combinación de los valores siguientes.

Valor	Significado
PFE_DONOTHYPHEN	Deshabilita la división automática de guiones.
PFE_KEEP	No hay saltos de página dentro del párrafo.
PFE_KEEPNEXT	No hay saltos de página entre este párrafo y el siguiente.
PFE_NOLINENUMBER	Deshabilita la numeración de líneas (no implementada).
PFE_NOWIDOWCONTROL	Deshabilita el control de viuda y huérfano para el párrafo seleccionado.
PFE_PAGEBREAKBEFORE	Inserta un salto de página antes del párrafo seleccionado.
PFE_RTLPARA	Muestra texto mediante el orden de lectura de derecha a izquierda (en Rich Edit 2.1 y versiones posteriores).
PFE_SIDEBYSIDE	Muestra párrafos en paralelo (no implementados).
PFE_TABLE	El párrafo es una fila de tabla.
PFE_TABLEROWDELIMITER	El párrafo es un delimitador inicial (U+FFF9 U+000D) o delimitador final (U+FFFB U+000D) de una fila de una tabla.

dxStartIndent

Tipo: long

Sangría de la primera línea del párrafo, en twips. La sangría de 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 de PFM_RIGHTINDENT en el miembro dwMask de .

dxOffset

Tipo: long

Sangría de la segunda y las líneas posteriores, en relación con la sangría de la primera línea, en twips. La primera línea se aplica sangría si este miembro es negativo o está fuera de la sangría 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 siguientes valores.

Valor	Significado
PFA_LEFT	Los párrafos se alinean con el margen izquierdo.
PFA_RIGHT	Los párrafos se alinean con el margen derecho.
PFA_CENTER	Los párrafos están centrados.
PFA_JUSTIFY	RichEdit 2.0:Se justifican los párrafos. Los controles de edición enriquecidos anteriores a RichEdit 3.0 muestran el texto alineado con el margen izquierdo.
PFA_FULL_INTERWORD	Los párrafos se justifican expandiendo solo los espacios en blanco.

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 compatibilidad con 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 visualización de control de edición enriquecida para versiones anteriores a Microsoft Rich Edit 3.0.

Valor	Significado
0	Pestaña Normal
1	Pestaña Centro
2	Pestaña alineada a la derecha
3	Tabulación decimal
4	Pestaña Barra de Word (barra vertical)

Los bits 28-31 pueden especificar uno de los siguientes valores para indicar el tipo de marcador de tabulación. Estos bits no afectan a la pantalla de control de edición enriquecida.

Valor	Significado
0	Sin líder
1	Líder punteado
2	Líder discontinuo
3	Líder subrayado
4	Líder de línea gruesa
5	Líder 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 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 de PFM_STYLE en el miembro dwMask de . Este miembro solo se incluye por motivos de 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 de

Tipo de interlineado. Para usar este miembro, establezca la marca PFM_LINESPACING en el miembro dwMask. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
0	Espaciado único. Se omite el miembro dyLineSpacing.
1	Espaciado uno y medio. Se omite el miembro dyLineSpacing.
2	Espaciado doble. Se omite el miembro dyLineSpacing.
3	El miembro dyLineSpacing especifica el espaciado de una línea a la siguiente, en twips. Sin embargo, si dyLineSpacing especifica un valor menor que un solo espaciado, el control muestra texto con espacio único.
4	El miembro dyLineSpacing especifica el espaciado de una línea a la siguiente, en twips. El control usa el espaciado exacto especificado, incluso si dyLineSpacing especifica un valor que es menor que el espaciado único.
5	El valor de dyLineSpacing / 20 es el espaciado, en líneas, de una línea a la siguiente. Por lo tanto, si se establece dyLineSpacing en 20, se genera texto con un solo espacio, 40 es doble espaciado, 60 es triple espaciado, etc.

bOutlineLevel

Tipo: byte de

Reservado; debe ser cero.

wShadingWeight

Tipo: word

Porcentaje de color de primer plano utilizado en sombreado. El miembro wShadingStyle especifica los colores de sombreado de primer y fondo. Un valor de 5 indica un color de sombreado que consta de un color de primer plano del 5 por ciento y un color de fondo del 95 por ciento. Para usar estos miembros, establezca la marca PFM_SHADING en el miembro dwMask de . 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 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 siguientes valores.

Valor	Significado
0	Ninguno
1	Horizontal oscuro
2	Vertical oscuro
3	Diagonal hacia abajo oscura
4	Diagonal hacia arriba oscura
5	Cuadrícula oscura
6	Trellis oscuros
7	Horizontal claro
8	Vertical claro
9	Diagonal hacia abajo de la luz
10	Iluminación diagonal hacia arriba
11	Cuadrícula de luz
12	Trellis ligeros

Los índices de color de primer plano y de fondo pueden ser uno de los siguientes valores.

Valor	Significado
0	Negro
1	Azul
2	Cian
3	Verde
4	Magenta
5	Rojo
6	Amarillo
7	Blanco
8	Azul oscuro
9	Cian oscuro
10	Verde oscuro
11	Magenta oscuro
12	Rojo oscuro
13	Amarillo oscuro
14	Gris oscuro
15	Gris claro

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 motivos de compatibilidad con interfaces TOM; el control de edición enriquecido almacena el valor, pero no lo usa para mostrar el texto o 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 motivos de compatibilidad con interfaces TOM; el control de edición enriquecido almacena el valor, pero las versiones de edición enriquecidas anteriores a la 3.0 no la usan para mostrar el texto o viñetas. Para usar este miembro, establezca la marca PFM_NUMBERINGSTYLE en el miembro dwMask . Este miembro puede ser uno de los siguientes valores.

Valor	Significado
PFNS_PAREN	Sigue el número con un paréntesis derecho.
PFNS_PARENS	Incluye el número entre paréntesis.
PFNS_PERIOD	Sigue el número con un punto.
PFNS_PLAIN	Muestra solo el número.
PFNS_NONUMBER	Continúa una lista numerada sin aplicar el siguiente número o viñeta.
PFNS_NEWNUMBER	Inicia un nuevo número con wNumberingStart.

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 de se incluye para la compatibilidad con las 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 de .

wBorderSpace

Tipo: word

Espacio entre el borde y el texto del párrafo, en twips. El miembro wBorderSpace de se incluye para la compatibilidad con Word; el control de edición enriquecida 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 de 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 de 0 a 7.

Valor	Significado
1	Borde izquierdo.
2	Borde derecho.
4	Borde superior.
8	Borde inferior.
16	Bordes interiores.
32	Bordes exteriores.
64	Colorear automáticamente. Si se establece este bit, no se usa el índice de color en bits de 12 a 15.

Especifique el estilo de borde con uno de los siguientes valores para los bits 8 a 11.

Valor	Significado
0	Ninguno
1	punto de 3/4
2	11 punto de/2
3	21 punto de/4
4	3 puntos
5	41 punto de/2
6	6 puntos
7	3/4 punto doble
8	11/2 punto doble
9	21/4 punto doble
10	3/4 punto gris
11	3/4 punto gris discontinuo

Especifique el color del borde con uno de los siguientes valores para los bits de 12 a 15. Este valor se omite si se establece el bit de color automático (bit 6).

Valor	Significado
0	Negro
1	Azul
2	Cian
3	Verde
4	Magenta
5	Rojo
6	Amarillo
7	Blanco
8	Azul oscuro
9	Cian oscuro
10	Verde oscuro
11	Magenta oscuro
12	Rojo oscuro
13	Amarillo oscuro
14	Gris oscuro
15	Gris claro

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	richedit.h

Consulte también

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT

Compartir a través de

estructura PARAFORMAT2 (Rich Edit 2.0)

Sintaxis

Miembros

Requisitos

Consulte también

Comentarios

Recursos adicionales