Metodo IHeaderCtrl::InsertColumn (mmc.h)

  • Articolo

Aggiunge una colonna a un riquadro dei risultati predefinito.

Sintassi

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

Parametri

[in] nCol

Indice in base zero della colonna inserita.

[in] title

Valore che specifica la stringa che rappresenta il titolo della colonna inserita. Questa stringa può avere una lunghezza massima di caratteri MAX_PATH .

[in] nFormat

Valore che specifica la posizione del testo all'interno della colonna. Per la colonna zero, nFormat deve essere LVCFMT_LEFT. Questo valore deve essere uno dei seguenti:

LVCFMT_LEFT

Il testo è allineato a sinistra.

LVCFMT_CENTER

Il testo è allineato al centro.

LVCFMT_RIGHT

Il testo è allineato a destra.

Nota Per usare le costanti LVCFMT_* , includere CommCtrl.h nel file di origine.
 

[in] nWidth

Valore che specifica la larghezza della colonna in pixel. Questo valore deve essere uno dei seguenti:

MMCLV_AUTO

MMC determina automaticamente la larghezza della colonna in base alla stringa del titolo.

HIDE_COLUMN

Introdotta in MMC 1.2. La colonna viene inserita, ma è nascosta. Tenere presente che l'utente può rendere visibile la colonna durante la personalizzazione di una visualizzazione elenco.

Per gli snap-in compilati con MMC 1.2 SDK, ma caricati in una versione precedente di MMC, HIDE_COLUMN viene interpretato come larghezza zero. L'utente può ampliare la colonna trascinandola con il mouse.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

MMC non persiste in memoria nessuna modifica apportata a un set di colonne a causa dell'azione di IHeaderCtrl::InsertColumn, pertanto gli snap-in devono aggiornare i dati di configurazione delle colonne persistenti dopo l'inserimento di colonne in un set di colonne. Per altre informazioni, vedere IHeaderCtrl2 e Column Persistence .

Note ai chiamanti

Le chiamate a InsertColumn hanno esito negativo se gli elementi sono già stati inseriti nella visualizzazione dei risultati.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione mmc.h
DLL Mmcndmgr.dll

Vedi anche

IHeaderCtrl

IHeaderCtrl2 e Persistenza colonna