Partilhar via


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

Define a largura, em pixels, de uma coluna específica.

Sintaxe

HRESULT SetColumnWidth(
  [in] int nCol,
  [in] int nWidth
);

Parâmetros

[in] nCol

Um índice baseado em zero que especifica o local da coluna em relação a outras colunas no painel de resultados.

[in] nWidth

Um valor que especifica a largura da coluna. Esse valor deve estar em pixels ou pode ser o seguinte valor:

MMCLV_AUTO

O MMC determina automaticamente a largura da coluna com base na largura do texto no título da coluna.

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::SetColumnWidth, portanto, os snap-ins devem atualizar dados de configuração de coluna persistentes depois de modificar a largura das colunas em um conjunto de colunas. Para obter mais informações, consulte IHeaderCtrl2 e Persistência de coluna.

O sinalizador HIDE_COLUMN para o parâmetro nWidth não tem suporte para SetColumnWidth. Se o snap-in precisar ocultar a coluna, ele deverá chamar IConsole::SelectScopeItem para reselecionar o item de escopo e, em seguida, na chamada resultante para o manipulador de notificação MMCN_SHOW do snap-in, ele deverá usar nWidth=HIDE_COLUMN ao inserir a coluna (na chamada para IHeaderCtrl::InsertColumn).

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

Confira também

IHeaderCtrl

Persistência de coluna e IHeaderCtrl2