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