IHeaderCtrl::InsertColumn-Methode (mmc.h)

Fügt einem Standardergebnisbereich eine Spalte hinzu.

Syntax

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

Parameter

[in] nCol

Ein nullbasierter Index der eingefügten Spalte.

[in] title

Ein Wert, der die Zeichenfolge angibt, die den Titel der eingefügten Spalte darstellt. Diese Zeichenfolge kann eine maximale Länge von MAX_PATH Zeichen aufweisen.

[in] nFormat

Ein Wert, der die Position des Texts in der Spalte angibt. Für Spalte null muss nFormatLVCFMT_LEFT sein. Dieser Wert muss einer der folgenden Werte sein:

LVCFMT_LEFT

Text ist linksbündig.

LVCFMT_CENTER

Text ist zentriert ausgerichtet.

LVCFMT_RIGHT

Text ist rechtsbündig.

Hinweis Um die LVCFMT_* -Konstanten zu verwenden, fügen Sie CommCtrl.h in Ihre Quelldatei ein.

 

[in] nWidth

Ein Wert, der die Breite der Spalte in Pixel angibt. Dieser Wert muss einer der folgenden Werte sein:

MMCLV_AUTO

MMC bestimmt automatisch die Breite der Spalte basierend auf der Titelzeichenfolge.

HIDE_COLUMN

Eingeführt in MMC 1.2. Die Spalte wird eingefügt, ist aber ausgeblendet. Beachten Sie, dass der Benutzer die Spalte beim Anpassen einer Listenansicht sichtbar machen kann.

Für Snap-Ins, die mit dem MMC 1.2 SDK erstellt wurden, aber in einer älteren Version von MMC geladen werden, wird HIDE_COLUMN als Breite von null interpretiert. Der Benutzer kann die Spalte erweitern, indem er sie mit der Maus zieht.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

MMC behält keine Änderungen an einem Spaltensatz aufgrund der Aktion von IHeaderCtrl::InsertColumn im Arbeitsspeicher bei, sodass Snap-Ins nach dem Einfügen von Spalten in einen Spaltensatz persistente Spaltenkonfigurationsdaten aktualisieren müssen. Weitere Informationen finden Sie unter IHeaderCtrl2 und Spaltenpersistenz .

Hinweise für Anrufer

Aufrufe von InsertColumn schlagen fehl, wenn elemente bereits in die Ergebnisansicht eingefügt wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	mmc.h
DLL	Mmcndmgr.dll

Weitere Informationen

IHeaderCtrl

IHeaderCtrl2 und Spaltenpersistenz