Share via

Estrutura PARAFORMAT (richedit.h)

  • Artigo

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
 Edição Avançada 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:: esse membro é chamado wReserved. Reservados; o valor deve ser zero.

Edição Avançada 2.0: Esse membro é chamado wEffects. Um sinalizador de bits que especifica um efeito de parágrafo. Ele é 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. Esse parâmetro pode usar 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 de parágrafo estiver sendo definida e PFM_OFFSETINDENT for especificada, esse membro será tratado como um valor relativo 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 das segundas e 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 valores a seguir.

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 .

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 Central
2
 Guia alinhada à direita
3
 Guia Decimal
4
 Word guia da barra (barra vertical)
 

Os bits 28-31 podem especificar um dos valores a seguir 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

   
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

PARAFORMAT2

Referência