Método IHeaderCtrl::InsertColumn (mmc.h)

Agrega una columna a un panel de resultados predeterminado.

Sintaxis

HRESULT InsertColumn(
  [in] int     nCol,
  [in] LPCWSTR title,
  [in] int     nFormat,
  [in] int     nWidth
);

Parámetros

[in] nCol

Índice de base cero de la columna que se va a insertar.

[in] title

Valor que especifica la cadena que representa el título de la columna que se va a insertar. Esta cadena puede tener una longitud máxima de MAX_PATH caracteres.

[in] nFormat

Valor que especifica la posición del texto dentro de la columna. Para la columna cero, nFormat debe ser LVCFMT_LEFT. Este valor debe ser uno de los siguientes:

LVCFMT_LEFT

El texto está alineado a la izquierda.

LVCFMT_CENTER

El texto está alineado centralmente.

LVCFMT_RIGHT

El texto está alineado a la derecha.

Nota Para usar las constantes LVCFMT_* , incluya CommCtrl.h en el archivo de origen.

 

[in] nWidth

Valor que especifica el ancho de la columna en píxeles. Este valor debe ser uno de los siguientes:

MMCLV_AUTO

MMC determina automáticamente el ancho de la columna en función de su cadena de título.

HIDE_COLUMN

Introducido en MMC 1.2. La columna se inserta, pero está oculta. Tenga en cuenta que el usuario puede hacer que la columna sea visible al personalizar una vista de lista.

En el caso de los complementos creados con el SDK de MMC 1.2, pero que se cargan en una versión anterior de MMC, HIDE_COLUMN se interpreta como un ancho cero. El usuario puede ampliar la columna arrastrándola con el mouse.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

MMC no conserva en memoria ningún cambio realizado en un conjunto de columnas debido a la acción de IHeaderCtrl::InsertColumn, por lo que los complementos deben actualizar los datos de configuración de columna persistentes después de insertar columnas en un conjunto de columnas. Consulte IHeaderCtrl2 y Persistencia de columnas para obtener más información.

Notas a los autores de llamadas

Se produce un error en las llamadas a InsertColumn si ya se han insertado elementos en la vista de resultados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	mmc.h
Archivo DLL	Mmcndmgr.dll

Consulte también

IHeaderCtrl

Persistencia de IHeaderCtrl2 y columna