Metodo IHeaderCtrl::InsertColumn (mmc.h)
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.
[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 |