Método ITextPara::AddTab (tom.h)

Artigo
03/13/2024

Adiciona uma guia no deslocamento tbPos, com o tipo tbAlign e o estilo de líder, tbLeader.

Sintaxe

HRESULT AddTab(
  [in] float tbPos,
  [in] long  tbAlign,
  [in] long  tbLeader
);

Parâmetros

[in] tbPos

Tipo: float

Novo deslocamento de tabulação, em pontos de ponto flutuante.

[in] tbAlign

Tipo: long

Opções de alinhamento para a posição da guia. Pode ser um dos seguintes.

Valor	Significado
tomAlignLeft	O texto é deixado justificado da posição da guia. Esse é o padrão.
tomAlignCenter	O texto é centralizado na posição da guia.
tomAlignRight	O texto é justificado corretamente da posição da guia.
tomAlignDecimal	O ponto decimal é definido na posição da guia. Isso é útil para alinhar uma coluna de números decimais.
tomAlignBar	Uma barra vertical é posicionada na posição da guia. O texto não é afetado. Barras de alinhamento em linhas próximas na mesma posição formam uma linha vertical contínua.

[in] tbLeader

Tipo: long

Estilo de caractere de líder. Um caractere de líder é o caractere usado para preencher o espaço gasto por um caractere de tabulação. Pode ser um dos seguintes.

Valor	Significado
tomSpaces	Espaços são usados. Esse é o padrão.
tomDots	Os ponto são usados.
tomDashes	Uma linha tracejada é usada.
tomLines	Uma linha sólida é usada.

Retornar valor

Tipo: HRESULT

Se ITextPara::AddTab for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
Valor	Significado
E_ACCESSDENIED	Acesso de gravação negado.
E_OUTOFMEMORY	Memória insuficiente.
CO_E_RELEASED	O objeto de formato de parágrafo é anexado a um intervalo que foi excluído.

Comentários

Supõe-se que nunca haja uma guia na posição zero. Se vários parágrafos forem descritos, o subconjunto comum de guias será retornado com 0x8000 na palavra superior do tipo de guia.

Requisitos

Requisito	Valor
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]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll