estrutura PARAFORMAT2 (richedit.h)

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

struct PARAFORMAT2 : _paraformat {
  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;
};

Herança

A estrutura PARAFORMAT2 implementa _paraformat.

Membros

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