PARAFORMAT2

[Esta é a documentação preliminar e estão sujeitos a alterações.]

A PARAFORMAT2 estrutura contém informações sobre o parágrafo formatação atributos em um Controlarar rich Editar. PARAFORMAT2 é uma extensão rich Editar 2.0 da estrutura PARAFORMAT . Rich Editar 2.0 permite que você use qualquer estrutura com as mensagens EM_GETPARAFORMAT e EM_SETPARAFORMAT.

typedef struct _paraformat {UINT cbSize; 
    _WPAD _wPad1; 
    DwMask DWORD; 
    PALAVRA wNumbering; 
    PALAVRA wReserved; / / redefinido como wEffects em PARAFORMAT2
    DxStartIndent longo; 
    DxRightIndent longo; 
    DxOffset longo; 
    PALAVRA wAlignment; 
    CTabCount curto; 
    LONGA rgxTabs [MAX_TAB_STOPS]; 
    DySpaceBefore longo;     / / espaçamento vertical antes para
    DySpaceAfter longo;      / / espaçamento vertical após para
    DyLineSpacing longo;     / / linha espaçamento dependendo da regra
    SStyle curto;            / / estilo alça
    BYTE bLineSpacingRule;  / / regra para linha espaçamento (ver tom.doc)
    BYTE bCRC;              / / reservado para CRC para pesquisa rápida
    PALAVRA wShadingWeight;    / / sombreamento em centésimos de um por cento
    PALAVRA wShadingStyle;     / / roer 0: estilo, 1: cfpat, 2: cbpat
    PALAVRA wNumberingStart;   / / valor para numeração inicial
    PALAVRA wNumberingStyle;   / / alinhamento, Romano/árabe, (),),., etc.
    PALAVRA wNumberingTab;     / / espaço aposta 1 travessão e 1-linha texto
    PALAVRA wBorderSpace;      / / espaço entre a borda e texto (twips)
    PALAVRA wBorderWidth;      / / largura da caneta (twips) da borda
    PALAVRA wBorders;          / / byte 0: bits especificar quais bordas
                             / / roer 2: borda estilo, 3: índice de cor
} PARAFORMAT2; 
# define wEffects wReserved 

Membros

cbSize
Especifica o tamanho, em bytes, dessa estrutura. Antes de passar essa estrutura para um Controlarar rich Editar, defina o cbSize para o tamanho da estrutura PARAFORMAT ou PARAFORMAT2 . Se cbSize é igual o tamanho de uma estrutura PARAFORMAT , o Controlarar usa apenas os PARAFORMAT Membros.
dwMask
Especifica as partes de PARAFORMAT2 estrutura que contêm válido informações. O dwMask membro pode ser uma combinação dos valores de dois conjuntos de sinalizadores de bit. Um conjunto indica os membros de estrutura são válidos. Outro conjunto indica os atributos válidos no membro wEffects.

Defina os seguintes valores para indicar os membros de estrutura válido.
Valor Significado
PFM_ALIGNMENT O membro wAlignment é válido.
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 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 dxStartIndent membro é válido. Se você estiver definindo o recuo, dxStartIndent especifica a quantidade para travessão relativo para o atual recuo.
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 dxStartIndent membro é válido e especifica o recuo da margem esquerda. Se PFM_STARTINDENT e PFM_OFFSETINDENT forem especificados, PFM_STARTINDENT tem precedência.
PFM_STYLE O membro sStyle é válido.
PFM_TABSTOPS Os membros cTabCount e rgxTabs são válidos.

Defina os seguintes valores para indicar os atributos válidos do membro wEffects.
Valor Significado
PFM_DONOTHYPHEN O valor PFE_DONOTHYPHEN é válido.
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 Os valores PFE_TABLEROW, PFE_TABLECELLEND e PFE_TABLECELL são válidos.

wNumbering
Especifica as opções para parágrafos numerados ou com marcadores. Para usar este membro, defina o sinalizador PFM_NUMBERING in dwMask membro. Esse membro pode ser uma dos seguinte valores.
Valor Significado
zero Sem numeração de parágrafos ou marcadores.
PFN_BULLET Inserir um marcador no início de cada parágrafo selecionado.

Rich Editar controles não exibem números de parágrafo. No entanto, para compatibilidade com interfaces de modelo de objeto de texto da Microsoft (TOM), wNumbering pode especificar um dos seguintes valores; armazena o valor do Controlarar rich Editar, mas não usá-lo para exibir o texto.
Valor Significado
2 Use algarismos arábicos (1, 2, 3,...).
3 Usar letras minúsculas (a, b, c,...).
4 Usar letras maiúsculas (A, B, C,...).
5 Usar algarismos romanos minúsculos (i, ii, iii,...).
6 Usar algarismos romanos maiúsculos (I, II, III,...).
7 Use uma seqüência de caracteres começando com o caractere Unicode especificado pelo membro wNumberingStart.

wReserved ou wEffects
Rich Editar 2.0: Um conjunto de bit sinalizadores que especificar efeitos de parágrafo. Esses sinalizadores são incluídos somente para compatibilidade com interfaces de TOM; armazena o valor do Controlarar rich Editar, mas não usá-lo para exibir o texto.

Esse membro pode ser uma combinação dos seguintes valores.
Valor Significado
PFE_DONOTHYPHEN Desativar a hifenização automática.
PFE_KEEP Sem quebra de página dentro do parágrafo.
PFE_KEEPNEXT Sem quebra de página entre este parágrafo e o próximo.
PFE_NOLINENUMBER Desativar a numeração de linhas.
PFE_NOWIDOWCONTROL Desativar o controle de viúva/órfã para esse parágrafo.
PFE_PAGEBREAKBEFORE Inserir uma quebra de página antes deste parágrafo.
PFE_RTLPARA Exibir o texto usando ordem de leitura da direita para a esquerda.
PFE_SIDEBYSIDE Exibir os parágrafos lado a lado.
PFE_TABLECELL O parágrafo em uma célula de tabela, mas não é o último parágrafo na célula.
PFE_TABLECELLEND O parágrafo é passado em uma célula de tabela.
PFE_TABLEROW O parágrafo descreve uma linha em uma tabela.

Rich Edit 1.0: Reservados; deve ser zero.

dxStartIndent
Especifica o recuo, em twips, de primeira linha do parágrafo. O recuo das linhas subseqüentes depende o membro dxOffset . Para usar o membro dxStartIndent , defina o sinalizador PFM_STARTINDENT ou PFM_OFFSETINDENT no dwMask membro.

Se você estiver definindo o recuo, use o sinalizador PFM_STARTINDENT para especificar um absoluto recuo da margem esquerda; ou use o sinalizador PFM_OFFSETINDENT para especificar um recuo relativo ao recuo atual do parágrafo. Use qualquer bandeira para recuperar o atual recuo.

dxRightIndent
Especifica o recuo, em twips, do lado direito do parágrafo, relativo para a margem direita. Para usar este membro, definir o sinalizador PFM_RIGHTINDENT in dwMask membro.
dxOffset
Especifica o recuo, em twips, da segunda linha e subseqüentes, relativo para o recuo da primeira linha. A primeira linha é recuada se este membro for negativo, ou recuadas para a esquerda é que este membro é positivo. Para usar este membro, definir o sinalizador PFM_OFFSET in dwMask membro.
wAlignment
Especifica o alinhamento de parágrafo. Para usar este membro, defina o sinalizador PFM_ALIGNMENT in dwMask membro. Esse membro pode ser uma dos seguinte valores.
Valor Significado
PFA_LEFT Os parágrafos são alinhados na margem esquerda.
PFA_RIGHT Parágrafos são alinhados com a margem direita.
PFA_CENTER Os parágrafos são centralizados.
PFA_JUSTIFY Rich Editar 2.0: Os parágrafos são justificados. Esse valor é incluído para compatibilidade com interfaces de TOM; Rich Editar controles exibir o texto alinhado na margem esquerda.

cTabCount
Especifica o número de paradas de tabulação definida na matriz rgxTabs.
rgxTabs
Uma 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 inferior especifica o deslocamento absoluto em twips. Para usar este membro, definir o sinalizador PFM_TABSTOPS in dwMask membro.

Rich Editar 2.0: Para compatibilidade com interfaces de TOM, você pode usar os 8 bits de ordem alta para armazenar informações adicionais sobre cada parada de tabulação. Esses bits não afetam a Exibir de Controlarar rich Editar.

Podem especificar um do seguinte valores para indicar o alinhamento de tabulação bits 24-27.
Valor Significado
0 Guia normal
1 Guia Centro de
2 Guia alinhado à direita
3 Tabulação decimal
4 Guia de barra do Word (barra vertical)

28-31 Bits podem especificar um do seguinte valores para indicar o tipo de guia de tabulação.
Valor Significado
0 Nenhum líder
1 Líder pontilhada
2 Líder tracejada
3 Líder do sublinhado
4 Líder de linha grossa
5 Líder de linha dupla

dySpaceBefore
Especifica o tamanho, em twips, o espaçamento do parágrafo acima. Para usar este membro, definir o sinalizador PFM_SPACEBEFORE in dwMask membro.
dySpaceAfter
Especifica o tamanho, em twips, o espaçamento abaixo do parágrafo. Para usar este membro, definir o sinalizador PFM_SPACEAFTER in dwMask membro.
dyLineSpacing
Especifica o espaçamento entre linhas. Para obter uma descrição de como esse valor é interpretado, consulte o membro bLineSpacingRule . Para usar este membro, definir o sinalizador PFM_LINESPACING in dwMask membro.
sStyle
Especifica o estilo de texto. Para usar este membro, defina o sinalizador PFM_STYLE in dwMask membro. Esse membro é incluído somente para compatibilidade com interfaces de TOM e o Microsoft Word; armazena o valor do Controlarar rich Editar, mas não usá-lo para exibir o texto.
bLineSpacingRule
Especifica o tipo de espaçamento de linha. Para usar este membro, defina o sinalizador PFM_SPACEAFTER in dwMask membro. Esse membro pode ser uma dos seguinte valores.
Valor Significado
0 Espaçamento simples. O membro de dyLineSpacing é ignorado.
1 Espaçamento de um ano e meio. O membro de dyLineSpacing é ignorado.
2 Espaçamento duplo. O membro de dyLineSpacing é ignorado.
3 O membro dyLineSpacing especifica o espaçamento, em twips, a partir de uma linha para a próxima. No entanto, se dyLineSpacing especifica um valor que seja menor que o espaçamento simples, o Controlarar exibe texto espaçamento.
4 O membro dyLineSpacing especifica o espaçamento, em twips, a partir de uma linha para a próxima. O controle usa o espaçamento exato especificado, mesmo se dyLineSpacing especifica um valor que é menor do que o espaçamento simples.
5 O valor de dyLineSpacing / 20 é o espaçamento, em linhas, de uma linha para outra. Assim, dyLineSpacing de configuração de texto espaçamento 20 produz, 40 com espaçamento duplo, 60 é triplo-espaçados e assim por diante.

bCRC
Reservados.
wShadingWeight
Especifica um valor entre zero e 100 para indicar a porcentagem da cor de primeiro plano para usar no sombreamento. O membro wShadingStyle especifica os primeiro plano e cores de sombreamento de plano de fundo. Um valor de 5 indica uma cor de sombreamento de cor 5 por cento do primeiro plano e cor de fundo de 95 por cento. Para usar esses membros, defina o sinalizador PFM_SHADING in dwMask membro. Esse membro é incluído somente para compatibilidade com o Microsoft Word; armazena o valor do Controlarar rich Editar, mas não usá-lo para exibir o texto.
wShadingStyle
Especifica o estilo e as cores usadas para sombreamento de plano de fundo. Bits 0 a 3 contêm o estilo de sombreamento, bits 4 a 7 contêm o índice de cor de primeiro plano e bits de 8 para 11 contêm o índice de cor de plano de fundo. Para usar este membro, defina o sinalizador PFM_SHADING in dwMask membro. Esse membro é incluído somente para compatibilidade com o Microsoft Word; armazena o valor do Controlarar rich Editar, mas não usá-lo para exibir o texto.

O estilo de sombreamento pode ser uma dos seguinte valores.
Valor Significado Valor Significado
0 Nenhum
1 Horizontal escura 7 Luz horizontal
2 Vertical escura 8 Luz vertical
3 Escuro para baixo diagonal 9 -Luz para baixo diagonal
4 Escuro até diagonal 10 Acender em diagonal
5 Grade escura 11 Barreira de luz
6 Treliça de escura 12 Treliça de luz

Os índices de cor do primeiro plano e plano de fundo podem ser uma dos seguinte valores.
Valor Cor Valor Cor
0 Preto 8 Azul escuro
1 Azul 9 Ciano escuro
2 Ciano 10 Verde-escuro
3 Verde 11 Magenta escuro
4 Magenta 12 Vermelho escuro
5 Vermelho 13 Amarelo escuro
6 Amarelo 14 Cinza escuro
7 Branco 15 Cinza claro

wNumberingStart
Especifica o número inicial ou o valor Unicode para usar para parágrafos numerados. Use este membro em conjunto com o membro de wNumbering . Esse membro é incluído somente para compatibilidade com interfaces de TOM; o Controlarar rich Editar armazena o valor mas não usá-lo para exibir texto ou marcadores. Para usar este membro, definir o sinalizador PFM_NUMBERINGSTART in dwMask membro.
wNumberingStyle
Especifica o estilo de numeração para usar com parágrafos numerados. Use este membro em conjunto com o membro de wNumbering . Esse membro é incluído somente para compatibilidade com interfaces de TOM; o Controlarar rich Editar armazena o valor mas não usá-lo para exibir texto ou marcadores. Para usar este membro, defina o sinalizador PFM_NUMBERINGSTYLE in dwMask membro. Esse membro pode ser uma dos seguinte valores.
Valor Significado
0 Siga o número com um parêntese direito.
1 Siga o número com período.
2 Coloque o número entre parênteses.
0 x 8000 Forçar números romanos.

wNumberingTab
Especifica o espaço mínimo, em twips, entre um número de parágrafo e o texto do parágrafo. Use este membro em conjunto com o membro de wNumbering . Esse membro é incluído somente para compatibilidade com interfaces de TOM; o Controlarar rich Editar armazena o valor mas não usá-lo para exibir texto. Para usar este membro, definir o sinalizador PFM_NUMBERINGTAB in dwMask membro.
wBorderSpace
Especifica o espaço, em twips, entre a borda e o texto do parágrafo. Os membros wBorderSpace, wBorderWidthe wBorders são incluídos para compatibilidade com o Microsoft Word; o rich Editar Controlarar armazena os valores mas não os usa para exibir texto. Para usar este membro, definir o sinalizador PFM_BORDER in dwMask membro.
wBorderWidth
Especifica a largura, em twips, da fronteira. Para usar este membro, definir o sinalizador PFM_BORDER in dwMask membro.
wBorders
Especifica a localização, estilo e cor da borda. Bits 0 a 7 especifique os locais de fronteira, bits de 8 para 11 especificar o estilo de borda e bits 12 a 15 especificar o índice de cor de borda. Para usar este membro, definir o sinalizador PFM_BORDER in dwMask membro.

Especifique os locais de Borda usando uma combinação dos seguintes valores.
Valor Significado
1 Borda esquerda
2 Borda direita
4 Limite superior
8 Borda inferior
16 Dentro das fronteiras
32 Fora das fronteiras
64 Autocolor. Se este bit for definido, o índice de cor em bits 12 a 15 não é usado.

Especificar o estilo de Borda usando um dos seguintes valores.
Valor Estilo Valor Estilo
0 Nenhum 6 ponto 6
1 ¾ ponto 7 ¾ ponto duplo
2 1 ponto 8 1 ponto duplo
3 ponto 2 9 2 ponto duplo
4 ponto 3 10 ¾ ponto cinza
5 ponto 4 11 ¾ ponto cinzento tracejado

Especifique a cor da borda usando um dos seguintes valores. Esse valor é ignorado se o bit de autocolor (6 bits) é definido.
Valor Cor Valor Cor
0 Preto 8 Azul escuro
1 Azul 9 Ciano escuro
2 Ciano 10 Verde-escuro
3 Verde 11 Magenta escuro
4 Magenta 12 Vermelho escuro
5 Vermelho 13 Amarelo escuro
6 Amarelo 14 Cinza escuro
7 Branco 15 Cinza claro

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em richedit.h.

Ver também

Visão geral sobre controles de Rich Editar, estruturas de Rich Editar, EM_GETPARAFORMAT, EM_SETPARAFORMAT, PARAFORMAT

Index