Header_GetItem巨集（commctrl.h）

取得標頭控件中專案的相關信息。您可以使用此巨集或明確傳送 HDM_GETITEM 訊息。

語法

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM phdi
);

hwndHD

類型：HWND

標頭控件的句柄。

i

類型：int

要擷取資訊之專案的索引。

phdi

類型：LPHDITEM

HDITEM 結構的指標。傳送訊息時，遮罩成員會指出所要求的信息類型。當訊息傳回時，其他成員會收到要求的資訊。如果遮罩成員指定零，訊息會傳回 TRUE，但不會將任何資訊複製到結構。

類型：BOOL

如果成功，則傳回 true true，否則會 傳回 false。

如果在 HDITEM 結構的遮罩成員中設定HDI_TEXT旗標，控件可能會變更結構 pszText 成員，以指向新的文字，而不是以所要求的文字填入緩衝區。應用程式不應該假設文字一律會放在要求的緩衝區中。

Header_GetItem 巨集的定義如下：

#define Header_GetItem(hwndHD, i, phdi)      \

    (BOOL)SendMessage((hwndHD), HDM_GETITEM,   \

    (WPARAM)(int)(i), (LPARAM)(LPHDITEM)(phdi))