Método IHeaderCtrl::InsertColumn (mmc.h)
Adiciona uma coluna a um painel de resultados padrão.
Sintaxe
HRESULT InsertColumn(
[in] int nCol,
[in] LPCWSTR title,
[in] int nFormat,
[in] int nWidth
);
Parâmetros
[in] nCol
Um índice baseado em zero da coluna que está sendo inserida.
[in] title
Um valor que especifica a cadeia de caracteres que representa o título da coluna que está sendo inserida. Essa cadeia de caracteres pode ter um comprimento máximo de MAX_PATH caracteres.
[in] nFormat
Um valor que especifica a posição do texto dentro da coluna. Para a coluna zero, nFormat deve ser LVCFMT_LEFT. O valor precisa ser um dos seguintes:
LVCFMT_LEFT
O texto é alinhado à esquerda.
LVCFMT_CENTER
O texto é alinhado centralmente.
LVCFMT_RIGHT
O texto está alinhado à direita.
[in] nWidth
Um valor que especifica a largura da coluna em pixels. O valor precisa ser um dos seguintes:
MMCLV_AUTO
O MMC determina automaticamente a largura da coluna com base em sua cadeia de caracteres de título.
HIDE_COLUMN
Introduzido no MMC 1.2. A coluna é inserida, mas está oculta. Lembre-se de que o usuário pode tornar a coluna visível ao personalizar uma exibição de lista.
Para snap-ins criados com o SDK do MMC 1.2, mas que são carregados em uma versão mais antiga do MMC, HIDE_COLUMN é interpretado como uma largura zero. O usuário pode ampliar a coluna arrastando-a com o mouse.
Retornar valor
Esse método pode retornar um desses valores.
Comentários
O MMC não persiste na memória nenhuma alteração feita em um conjunto de colunas devido à ação de IHeaderCtrl::InsertColumn, portanto, os snap-ins devem atualizar os dados de configuração de coluna persistentes depois de inserir colunas em um conjunto de colunas. Consulte IHeaderCtrl2 e Persistência de Coluna para obter mais informações.
Anotações para chamadores
As chamadas para InsertColumn falharão se algum item já tiver sido inserido na exibição de resultado.Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| DLL | Mmcndmgr.dll |