Header_GetOrderArray巨集 (commctrl.h)
取得標頭控件中專案的目前由左至右順序。 您可以使用此巨集或明確傳送 HDM_GETORDERARRAY 訊息。
語法
BOOL Header_GetOrderArray(
HWND hwnd,
int iCount,
int *lpi
);
參數
hwnd
類型:HWND
標頭控件的句柄。
iCount
類型:int
lpiArray 可以保存的整數元素數目。 這個值必須等於控件中的項目數(請參閱 HDM_GETITEMCOUNT)。
lpi
類型:int*
整數陣列的指標,這個陣列會接收標頭中專案的索引值。
傳回值
類型:BOOL
如果成功,則會傳回非零,且位於 lpiArray 的緩衝區 會依照標頭控件中每個專案的項目編號,依它們從左至右出現的順序接收。 否則傳回零。
言論
lpiArray 中的元素數目是在 iCount 中指定,而且必須等於控件中的項目數。 例如,下列代碼段會保留足夠的記憶體來保存索引值。
int iItems,
*lpi;
// Get memory for buffer
if((iItems = SendMessage(hwnd, HDM_GETITEMCOUNT, 0,0))!=-1)
if(!(lpiArray = calloc(iItems,sizeof(int))))
MessageBox(hwnd, "Out of memory.","Error", MB_OK);
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | commctrl.h |