Estrutura PARAFORMAT (richedit.h)

Contém informações sobre atributos de formatação de parágrafo em um controle de edição avançada. Essa estrutura é usada com as mensagens EM_GETPARAFORMAT e EM_SETPARAFORMAT.

No Microsoft Rich Edit 2.0, a estrutura 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 EM_GETPARAFORMAT e EM_SETPARAFORMAT.

Sintaxe

typedef struct _paraformat {
  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];
} PARAFORMAT;

Membros

cbSize

Tipo: UINT

Tamanho da estrutura, em bytes. O membro deve ser preenchido antes de passar para o controle de edição avançada.

dwMask

Tipo: DWORD

Membros que contêm informações ou atributos válidos a serem definidos. Esse parâmetro pode ser nenhum ou uma combinação dos valores a seguir. Se PFM_STARTINDENT e PFM_OFFSETINDENT forem especificados, PFM_STARTINDENT terá precedência.

Valor	Significado
PFM_ALIGNMENT	O membro wAlignment é válido.
PFM_NUMBERING	O membro wNumbering é válido.
PFM_OFFSET	O membro dxOffset é válido.
PFM_OFFSETINDENT	O membro dxStartIndent é válido e especifica um valor relativo.
PFM_RIGHTINDENT	O membro dxRightIndent é válido.
PFM_RTLPARA	Rich Edit 2.0: o membro wEffects é válido
PFM_STARTINDENT	O membro dxStartIndent é válido.
PFM_TABSTOPS	Os membros cTabStobs e rgxTabStops são válidos.

wNumbering

Tipo: WORD

Valor que especifica opções de numeração. Esse membro pode ser zero ou PFN_BULLET.

wReserved

Tipo: WORD

Rich Edit 1.0:: este membro é nomeado wReserved. Reservado; o valor deve ser zero.

Rich Edit 2.0: Este membro é nomeado wEffects. Um sinalizador de bits que especifica um efeito de parágrafo. Ele é incluído apenas para compatibilidade com interfaces TOM; o controle rich edit armazena o valor, mas não o usa para exibir o texto. Esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
0	Exibe texto usando a ordem de leitura da esquerda para a direita. Esse é o padrão.
PFE_RLTPARA	Exibe texto usando a ordem de leitura da direita para a esquerda.

wEffects

dxStartIndent

Tipo: LONG

Recuo da primeira linha no parágrafo, em twips. Se a formatação do parágrafo estiver sendo definida e PFM_OFFSETINDENT for especificada, esse membro será tratado como um valor relativo que é adicionado ao recuo inicial de cada parágrafo afetado.

dxRightIndent

Tipo: LONG

Tamanho, do recuo à direita em relação à margem direita, em twips.

dxOffset

Tipo: LONG

Recuo da segunda e das linhas subsequentes de um parágrafo em relação ao recuo inicial, em twips. A primeira linha será recuada se esse membro for negativo ou recuado se esse membro for positivo.

wAlignment

Tipo: WORD

Valor que especifica o alinhamento do parágrafo. Esse membro pode ser um dos seguintes valores.

Valor	Significado
PFA_CENTER	Os parágrafos são centralizados.
PFA_LEFT	Os parágrafos são alinhados com a margem esquerda.
PFA_RIGHT	Os parágrafos são alinhados com a margem direita.

cTabCount

Tipo: SHORT

Número de paradas de tabulação.

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

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

PARAFORMAT2

de referência de