estrutura PARAFORMAT2 (Rich Edit 2.0)

Artigo
08/15/2024

Contém informações sobre atributos de formatação de parágrafo em um controle de edição avançada. PARAFORMAT2 é uma extensão do Microsoft Rich Edit 2.0 da estrutura PARAFORMAT. O Microsoft Rich Edit 2.0 permite que você use qualquer estrutura com as mensagens EM_GETPARAFORMAT e EM_SETPARAFORMAT.

Sintaxe

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;

Membros

cbSize

Tipo: UINT

Tamanho da estrutura, em bytes. Antes de passar essa estrutura para um controle de edição avançada, defina cbSize para o tamanho da estrutura PARAFORMAT ou PARAFORMAT2. Se cbSize for igual ao tamanho de uma estrutura de PARAFORMAT, o controle usará apenas os membros PARAFORMAT.

dwMask

Tipo: DWORD

Os membros da estrutura PARAFORMAT2 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 wEffects.

Defina os valores a seguir para indicar os membros válidos da estrutura.

Valor	Significado
PFM_ALIGNMENT	O membro wAlignment é válido.
PFM_ALL	Uma combinação dos seguintes valores: PFM_STARTINDENT, PFM_RIGHTINDENT, PFM_OFFSET, PFM_ALIGNMENT, PFM_TABSTOPS, PFM_NUMBERING, PFM_OFFSETINDENT e PFM_RTLPARA.
PFM_ALL2	Uma combinação dos seguintes valores: PFM_ALL, PFM_EFFECTS, PFM_SPACEBEFORE, PFM_SPACEAFTER, PFM_LINESPACING, PFM_STYLE, PFM_SHADING, PFM_BORDER, PFM_NUMBERINGTAB, PFM_NUMBERINGSTART e PFM_NUMBERINGSTYLE.
PFM_BORDER	Os membros wBorderSpace, wBorderWidthe wBorders são válidos.
PFM_LINESPACING	Os membros dyLineSpacing e bLineSpacingRule são válidos.
PFM_NUMBERING	O membro wNumbering é válido.
PFM_NUMBERINGSTART	O membro do wNumberingStart é válido.
PFM_NUMBERINGSTYLE	O membro wNumberingStyle é válido.
PFM_NUMBERINGTAB	O membro wNumberingTab é válido.
PFM_OFFSET	O membro dxOffset é válido.
PFM_OFFSETINDENT	O membro dxStartIndent é válido. Se você estiver definindo o recuo, dxStartIndent especifica o valor a recuar em relação ao recuo atual.
PFM_OUTLINELEVEL	O membro bOutlineLevel é válido.
PFM_RIGHTINDENT	O membro dxRightIndent é válido.
PFM_SHADING	Os membros wShadingWeight e wShadingStyle são válidos.
PFM_SPACEAFTER	O membro dySpaceAfter é válido.
PFM_SPACEBEFORE	O membro dySpaceBefore é válido.
PFM_STARTINDENT	O membro dxStartIndent é válido e especifica o recuo da margem esquerda. Se PFM_STARTINDENT e PFM_OFFSETINDENT forem especificados, PFM_STARTINDENT terá precedência.
PFM_STYLE	O membro sStyle do é válido.
PFM_TABSTOPS	Os membros cTabCount e rgxTabs são válidos.

Defina os valores a seguir para indicar os atributos válidos do membro wEffects.

Valor	Significado
PFM_DONOTHYPHEN	O valor PFE_DONOTHYPHEN é válido.
PFM_EFFECTS	Uma combinação dos seguintes valores: PFM_RTLPARA, PFM_KEEP, PFM_KEEPNEXT, PFM_TABLE, PFM_PAGEBREAKBEFORE, PFM_NOLINENUMBER, PFM_NOWIDOWCONTROL, PFM_DONOTHYPHEN, PFM_SIDEBYSIDE e PFM_TABLEROWDELIMITER.
PFM_KEEP	O valor PFE_KEEP é válido.
PFM_KEEPNEXT	O valor PFE_KEEPNEXT é válido.
PFM_NOLINENUMBER	O valor PFE_NOLINENUMBER é válido.
PFM_NOWIDOWCONTROL	O valor PFE_NOWIDOWCONTROL é válido.
PFM_PAGEBREAKBEFORE	O valor PFE_PAGEBREAKBEFORE é válido.
PFM_RTLPARA	O valor PFE_RTLPARA é válido.
PFM_SIDEBYSIDE	O valor PFE_SIDEBYSIDE é válido.
PFM_TABLE	O valor PFE_TABLE é válido.
PFM_TABLEROWDELIMITER	O valor PFE_TABLEROWDELIMITER é válido.

wNumbering

Tipo: WORD

Opções usadas para parágrafos com marcadores ou numerados. Para usar esse membro, defina o sinalizador PFM_NUMBERING no membro dwMask .

Esse membro pode ser um dos seguintes valores.

Valor	Significado
zero	Sem numeração de parágrafo ou marcadores.
PFN_BULLET	Insira um marcador no início de cada parágrafo selecionado.

As versões rich edit anteriores à versão 3.0 não exibem números de parágrafo. No entanto, para compatibilidade com interfaces TOM (modelo de objeto de texto) do Microsoft , wNumbering pode especificar um dos valores a seguir. (O controle de edição avançada armazena o valor, mas não o usa para exibir o texto.)

Valor	Significado
PFN_ARABIC	Use números árabes (0, 1, 2 e assim por diante).
PFN_LCLETTER	Use letras minúsculas (a, b, c e assim por diante).
PFN_LCROMAN	Use letras romanas minúsculas (i, ii, iii e assim por diante).
PFN_UCLETTER	Use letras maiúsculas (A, B, C e assim por diante).
PFN_UCROMAN	Use letras romanas maiúsculas (I, II, III e assim por diante).
7	Usa uma sequência de caracteres começando com o caractere Unicode especificado pelo membro wNumberingStart.

wReserved

wEffects

Tipo: WORD

Esse membro também é conhecido como wReserved para o Microsoft Rich Edit 1.0 porque estava reservado.

Rich Edit 1.0: Reservado; o valor deve ser zero.

Rich Edit 2.0: Um conjunto de sinalizadores de bits que especificam efeitos de parágrafo. Esses sinalizadores são incluídos apenas para compatibilidade com interfaces TOM; o controle rich edit armazena o valor, mas não o usa para exibir o texto.

Esse membro pode ser uma combinação dos valores a seguir.

Valor	Significado
PFE_DONOTHYPHEN	Desabilita a hifenização automática.
PFE_KEEP	Nenhuma quebra de página dentro do parágrafo.
PFE_KEEPNEXT	Nenhuma quebra de página entre este parágrafo e o próximo.
PFE_NOLINENUMBER	Desabilita a numeração de linha (não implementada).
PFE_NOWIDOWCONTROL	Desabilita o controle de viúva e órfão para o parágrafo selecionado.
PFE_PAGEBREAKBEFORE	Insere uma quebra de página antes do parágrafo selecionado.
PFE_RTLPARA	Exibe texto usando a ordem de leitura da direita para a esquerda (em Rich Edit 2.1 e posterior).
PFE_SIDEBYSIDE	Exibe parágrafos lado a lado (não implementados).
PFE_TABLE	O parágrafo é uma linha de tabela.
PFE_TABLEROWDELIMITER	O parágrafo é um delimitador de início (U+FFF9 U+000D) ou delimitador final (U+FFFB U+000D) de uma linha em uma tabela.

dxStartIndent

Tipo: LONG

Recuo da primeira linha do parágrafo, em twips. O recuo das linhas subsequentes depende do membro dxOffset. Para usar o membro dxStartIndent, defina o sinalizador PFM_STARTINDENT ou PFM_OFFSETINDENT no membro dwMask. Se você estiver definindo o recuo, use o sinalizador PFM_STARTINDENT para especificar um recuo absoluto da margem esquerda; ou use o sinalizador PFM_OFFSETINDENT para especificar um recuo relativo ao recuo atual do parágrafo. Use qualquer sinalizador para recuperar o recuo atual.

dxRightIndent

Tipo: LONG

Recuo do lado direito do parágrafo, em relação à margem direita, em twips. Para usar esse membro, defina o sinalizador PFM_RIGHTINDENT no membro dwMask .

dxOffset

Tipo: LONG

Recuo da segunda e das linhas subsequentes, em relação ao recuo da primeira linha, em twips. A primeira linha será recuada se esse membro for negativo ou recuado se esse membro for positivo. Para usar esse membro, defina o sinalizador PFM_OFFSET no membro dwMask .

wAlignment

Tipo: WORD

Alinhamento de parágrafo. Para usar esse membro, defina o sinalizador PFM_ALIGNMENT no membro dwMask. Esse membro pode ser um dos seguintes valores.

Valor	Significado
PFA_LEFT	Os parágrafos são alinhados com a margem esquerda.
PFA_RIGHT	Os parágrafos são alinhados com a margem direita.
PFA_CENTER	Os parágrafos são centralizados.
PFA_JUSTIFY	RichEdit 2.0:Parágrafos são justificados. Controles de edição avançada anteriores ao RichEdit 3.0 exibem o texto alinhado com a margem esquerda.
PFA_FULL_INTERWORD	Parágrafos são justificados expandindo os espaços em branco sozinhos.

cTabCount

Tipo: SHORT

Número de paradas de tabulação definidas na matriz de rgxTabs .

rgxTabs[MAX_TAB_STOPS]

Tipo: LONG

Matriz de posições de parada de tabulação absoluta. Cada elemento na matriz especifica informações sobre uma parada de tabulação. Os 24 bits de ordem baixa especificam o deslocamento absoluto, em twips. Para usar esse membro, defina o sinalizador PFM_TABSTOPS no membro dwMask .

Rich Edit 2.0: Para compatibilidade com interfaces TOM, você pode usar os oito bits de alta ordem para armazenar informações adicionais sobre cada parada de tabulação.

Os bits 24-27 podem especificar um dos seguintes valores para indicar o alinhamento da guia. Esses bits não afetam a exibição de controle de edição avançada para versões anteriores ao Microsoft Rich Edit 3.0.

Valor	Significado
0	Guia comum
1	Guia Central
2	Guia alinhada à direita
3	Guia Decimal
4	Guia barra de palavras (barra vertical)

Os bits 28-31 podem especificar um dos seguintes valores para indicar o tipo de líder de guia. Esses bits não afetam a exibição de controle de edição avançada.

Valor	Significado
0	Nenhum líder
1	Líder pontilhado
2	Líder tracejado
3	Líder sublinhado
4	Líder de linha grossa
5	Líder de linha dupla

dySpaceBefore

Tipo: LONG

Tamanho do espaçamento acima do parágrafo, em twips. Para usar esse membro, defina o sinalizador PFM_SPACEBEFORE no membro dwMask . O valor deve ser maior ou igual a zero.

dySpaceAfter

Tipo: LONG

Especifica o tamanho do espaçamento abaixo do parágrafo, em twips. Para usar esse membro, defina o sinalizador PFM_SPACEAFTER no membro dwMask . O valor deve ser maior ou igual a zero.

dyLineSpacing

Tipo: LONG

Espaçamento entre linhas. Para obter uma descrição de como esse valor é interpretado, consulte o membro bLineSpacingRule. Para usar esse membro, defina o sinalizador PFM_LINESPACING no membro dwMask.

sStyle

Tipo: SHORT

Estilo de texto. Para usar esse membro, defina o sinalizador PFM_STYLE no membro dwMask . Esse membro é incluído apenas para compatibilidade com interfaces TOM e Word; o controle rich edit armazena o valor, mas não o usa para exibir o texto.

bLineSpacingRule

Tipo: BYTE

Tipo de espaçamento de linha. Para usar esse membro, defina o sinalizador PFM_LINESPACING no membro dwMask. Esse membro pode ser um dos seguintes valores.

Valor	Significado
0	Espaçamento único. O membro dyLineSpacing é ignorado.
1	Espaçamento um e meio. O membro dyLineSpacing é ignorado.
2	Espaçamento duplo. O membro dyLineSpacing é ignorado.
3	O membro dyLineSpacing especifica o espaçamento de uma linha para a outra, em twips. No entanto, se dyLineSpacing especificar um valor menor que o espaçamento único, o controle exibirá texto com espaçamento único.
4	O membro dyLineSpacing especifica o espaçamento de uma linha para a outra, em twips. O controle usa o espaçamento exato especificado, mesmo que dyLineSpacing especificar um valor menor que um único espaçamento.
5	O valor de dyLineSpacing/20 é o espaçamento, em linhas, de uma linha para a outra. Assim, a configuração dyLineSpacing para 20 produz texto com espaçamento único, 40 é espaçado duas vezes, 60 é espaçado triplo e assim por diante.

bOutlineLevel

Tipo: BYTE

Reservado; deve ser zero.

wShadingWeight

Tipo: WORD

Cor de primeiro plano percentual usada no sombreamento. O membro wShadingStyle especifica as cores de sombreamento em primeiro plano e plano de fundo. Um valor de 5 indica uma cor de sombreamento que consiste em 5% de cor de primeiro plano e 95% de cor do plano de fundo. Para usar esses membros, defina o sinalizador PFM_SHADING no membro dwMask . Esse membro é incluído apenas para compatibilidade com o Word; o controle rich edit armazena o valor, mas não o usa para exibir o texto.

wShadingStyle

Tipo: WORD

Estilo e cores usados para sombreamento de plano de fundo. Os bits 0 a 3 contêm o estilo de sombreamento, os bits 4 a 7 contêm o índice de cores de primeiro plano e os bits de 8 a 11 contêm o índice de cores de plano de fundo. Para usar esse membro, defina o sinalizador PFM_SHADING no membro dwMask. Esse membro é incluído apenas para compatibilidade com o Word; o controle rich edit armazena o valor, mas não o usa para exibir o texto.

O estilo de sombreamento pode ser um dos seguintes valores.

Valor	Significado
0	Nenhum
1	Horizontal escuro
2	Vertical escura
3	Diagonal escura para baixo
4	Diagonais escuras
5	Grade escura
6	Treliças escuras
7	Horizontal claro
8	Vertical claro
9	Diagonais de luz para baixo
10	Acender diagonalmente
11	Grade de luz
12	Treliças leves

Os índices de cor de plano de fundo e de primeiro plano podem ser um dos valores a seguir.

Valor	Significado
0	Preto
1	Azul
2	Ciano
3	Verde
4	Magenta
5	Vermelho
6	Amarelo
7	Branco
8	Azul escuro
9	Ciano escuro
10	Verde escuro
11	Magenta escura
12	Vermelho escuro
13	Amarelo escuro
14	Cinza escuro
15	Cinza claro

wNumberingStart

Tipo: WORD

Número inicial ou valor Unicode usado para parágrafos numerados. Use esse membro em conjunto com o membro wNumbering do . Esse membro é incluído apenas para compatibilidade com interfaces TOM; o controle rich edit armazena o valor, mas não o usa para exibir o texto ou marcadores. Para usar esse membro, defina o sinalizador PFM_NUMBERINGSTART no membro dwMask.

wNumberingStyle

Tipo: WORD

Estilo de numeração usado com parágrafos numerados. Use esse membro em conjunto com o membro wNumbering do . Esse membro é incluído apenas para compatibilidade com interfaces TOM; o controle de edição avançada armazena o valor, mas as versões de edição avançada anteriores à 3.0 não o usam para exibir o texto ou marcadores. Para usar esse membro, defina o sinalizador PFM_NUMBERINGSTYLE no membro dwMask . Esse membro pode ser um dos seguintes valores.

Valor	Significado
PFNS_PAREN	Segue o número com um parêntese direito.
PFNS_PARENS	Coloca o número entre parênteses.
PFNS_PERIOD	Segue o número com um período.
PFNS_PLAIN	Exibe apenas o número.
PFNS_NONUMBER	Continua uma lista numerada sem aplicar o próximo número ou marcador.
PFNS_NEWNUMBER	Inicia um novo número com wNumberingStart.

wNumberingTab

Tipo: WORD

Espaço mínimo entre um número de parágrafo e o texto do parágrafo, em twips. Use esse membro em conjunto com o membro wNumbering do . O membro wNumberingTab está incluído para compatibilidade com interfaces TOM; anterior ao Microsoft Rich Edit 3.0, o controle rich edit armazena o valor, mas não o usa para exibir texto. Para usar esse membro, defina o sinalizador PFM_NUMBERINGTAB no membro dwMask .

wBorderSpace

Tipo: WORD

O espaço entre a borda e o texto do parágrafo, em twips. O membro wBorderSpace está incluído para compatibilidade com o Word; o controle rich edit armazena os valores, mas não os usa para exibir texto. Para usar esse membro, defina o sinalizador PFM_BORDER no membro dwMask .

wBorderWidth

Tipo: WORD

Largura da borda, em twips. Para usar esse membro, defina o sinalizador PFM_BORDER no membro dwMask .

wBorders

Tipo: WORD

Local, estilo e cor da borda. Os bits 0 a 7 especificam os locais de borda, os bits 8 a 11 especificam o estilo da borda e os bits de 12 a 15 especificam o índice de cor da borda. Para usar esse membro, defina o sinalizador PFM_BORDER no membro dwMask .

Especifique os locais de borda usando uma combinação dos seguintes valores nos bits 0 a 7.

Valor	Significado
1	Borda esquerda.
2	Borda direita.
4	Borda superior.
8	Borda inferior.
16	Dentro de bordas.
32	Bordas externas.
64	Autocolorir. Se esse bit for definido, o índice de cores nos bits 12 a 15 não será usado.

Especifique o estilo de borda usando um dos seguintes valores para os bits 8 a 11.

Valor	Significado
0	Nenhum
1	3/4 pontos de
2	11/2 ponto
3	21 ponto de/4
4	3 pontos
5	41/2 ponto
6	6 pontos
7	3/4 pontos duplo
8	11/2 ponto duplo
9	21/4 ponto duplo
10	3/4 ponto cinza
11	3/4 ponto cinza tracejado

Especifique a cor da borda usando um dos seguintes valores para os bits de 12 a 15. Esse valor será ignorado se o bit de autocolorção (bit 6) estiver definido.

Valor	Significado
0	Preto
1	Azul
2	Ciano
3	Verde
4	Magenta
5	Vermelho
6	Amarelo
7	Branco
8	Azul escuro
9	Ciano escuro
10	Verde escuro
11	Magenta escura
12	Vermelho escuro
13	Amarelo escuro
14	Cinza escuro
15	Cinza claro

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

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT

Compartilhar via

estrutura PARAFORMAT2 (Rich Edit 2.0)

Sintaxe

Membros

Requisitos

Consulte também

Comentários

Recursos adicionais