Share via

estrutura PARAFORMAT2 (Edição Avançada 2.0)

  • Artigo

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 como o tamanho da estrutura PARAFORMAT ou PARAFORMAT2 . Se cbSize for igual ao tamanho de uma estrutura 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 que são 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, wBorderWidth e 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 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 especificará 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 é 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 valores a seguir.

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 ) da 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 Microsoft Rich Edit 1.0 porque ele foi reservado.

Edição Avançada 1.0: Reservados; o valor deve ser zero.

Edição Avançada 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 de edição avançada 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 Edição Avançada 2.1 e posterior).
PFE_SIDEBYSIDE
 Exibe parágrafos lado a lado (não implementado).
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 em relação 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 valores a seguir.

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
 Os 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 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 .

Edição Avançada 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 valores a seguir 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 Centralizar
2
 Guia alinhada à direita
3
 Guia Decimal
4
 guia barra de Word (barra vertical)
 

Os bits 28-31 podem especificar um dos valores a seguir para indicar o tipo de guia líder. Esses bits não afetam a exibição do 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 de edição avançada armazena o valor, mas não o usa para exibir o texto.

bLineSpacingRule

Tipo: BYTE

Tipo de espaçamento entre linhas. Para usar esse membro, defina o sinalizador PFM_LINESPACING no membro dwMask . Esse membro pode ser um dos valores a seguir.

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 outra, em twips. No entanto, se dyLineSpacing especificar um valor menor que um espaçamento único, o controle exibirá texto com espaçamento único.
4
 O membro dyLineSpacing especifica o espaçamento de uma linha para outra, em twips. O controle usa o espaçamento exato especificado, mesmo que dyLineSpacing especifique 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. Portanto, definir dyLineSpacing como 20 produz texto com espaçamento único, 40 tem espaçamento duplo, 60 tem espaçamento triplo e assim por diante.

bOutlineLevel

Tipo: BYTE

Reservados; deve ser zero.

wShadingWeight

Tipo: WORD

Porcentagem de cor de primeiro plano 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 da tela de fundo. Para usar esses membros, defina o sinalizador PFM_SHADING no membro dwMask . Esse membro é incluído apenas para compatibilidade com Word; o controle de edição avançada 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 8 a 11 contêm o índice de cor da tela de fundo. Para usar esse membro, defina o sinalizador PFM_SHADING no membro dwMask . Esse membro é incluído apenas para compatibilidade com Word; o controle de edição avançada armazena o valor, mas não o usa para exibir o texto.

O estilo de sombreamento pode ser um dos valores a seguir.

Valor Significado
0
 Nenhum
1
 Horizontal escuro
2
 Vertical escuro
3
 Diagonal escura para baixo
4
 Diagonal escura para cima
5
 Grade escura
6
 Treliça escura
7
 Horizontal claro
8
 Vertical claro
9
 Diagonal para baixo
10
 Diagonais claros
11
 Grade de luz
12
 Treliça leve
 

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

Valor Significado
0
 Preto
1
 Azul
2
 Ciano
3
 Verde
4
 Magenta
5
 Vermelho
6
 Amarelo
7
 Branca
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 . Esse membro é incluído apenas para compatibilidade com interfaces TOM; o controle de edição avançada 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 . Esse membro é incluído apenas para compatibilidade com interfaces TOM; o controle de edição avançada armazena o valor, mas versões de edição avançadas 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 valores a seguir.

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 ponto final.
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 . O membro wNumberingTab está incluído para compatibilidade com interfaces TOM; anterior ao Microsoft Rich Edit 3.0, o controle de edição avançada 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 Word; o controle de edição avançada 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 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 valores a seguir nos bits 0 a 7.

Valor Significado
1
 Borda esquerda.
2
 Borda direita.
4
 Borda superior.
8
 Borda inferior.
16
 Bordas internas.
32
 Bordas externas.
64
 Autocolor. 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 valores a seguir para os bits 8 a 11.

Valor Significado
0
 Nenhum
1
 3/4 pontos
2
 11/2 pontos
3
 214/ pontos
4
 3 pontos
5
 41/2 pontos
6
 6 pontos
7
 3/4 pontos duplos
8
 11/2 pontos duplo
9
 21/4 pontos duplo
10
 3/Cinza de 4 pontos
11
 3/Cinza de 4 pontos 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 cor automática (bit 6) estiver definido.

Valor Significado
0
 Preto
1
 Azul
2
 Ciano
3
 Verde
4
 Magenta
5
 Vermelho
6
 Amarelo
7
 Branca
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

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho richedit.h

Confira também

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT