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

Artículo
08/26/2023

Agrega una pestaña en el desplazamiento tbPos, con el tipo tbAlign y el estilo leader, tbLeader.

Sintaxis

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

Parámetros

[in] tbPos

Tipo: float

Nuevo desplazamiento de tabulación, en puntos de punto flotante.

[in] tbAlign

Tipo: long

Opciones de alineación para la posición de la pestaña. Puede ser uno de los siguientes.

Valor	Significado
tomAlignLeft	El texto está justificado desde la posición de tabulación. Este es el valor predeterminado.
tomAlignCenter	El texto se centra en la posición de la pestaña.
tomAlignRight	El texto está justificado a la derecha desde la posición de tabulación.
tomAlignDecimal	El separador decimal se establece en la posición de tabulación. Esto es útil para alinear una columna de números decimales.
tomAlignBar	Una barra vertical se coloca en la posición de tabulación. El texto no se ve afectado. Las barras de alineación en líneas cercanas en la misma posición forman una línea vertical continua.

[in] tbLeader

Tipo: long

Estilo de carácter de líder. Un carácter de guía es el carácter que se usa para rellenar el espacio que toma un carácter de tabulación. Puede ser uno de los siguientes.

Valor	Significado
tomSpaces	Se usan espacios. Este es el valor predeterminado.
tomDots	Se usan puntos.
tomDashes	Se usa una línea discontinua.
tomLines	Se usa una línea sólida.

Valor devuelto

Tipo: HRESULT

Si ITextPara::AddTab se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error COM. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
Valor	Significado
E_ACCESSDENIED	Se deniega el acceso de escritura.
E_OUTOFMEMORY	Memoria insuficiente.
CO_E_RELEASED	El objeto de formato de párrafo se adjunta a un intervalo que se ha eliminado.

Comentarios

Se supone que nunca hay una pestaña en la posición cero. Si se describen varios párrafos, se devolverá el subconjunto común de pestañas con 0x8000 en la palabra superior del tipo de pestaña.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h
Archivo DLL	Msftedit.dll