CHeaderCtrl::GetOrderArray

[アーティクル]
08/09/2011

ヘッダーコントロールの項目の左から右への順序を取得します。

BOOL GetOrderArray(
   LPINT piArray,
   int iCount
);

パラメーター

piArray
ヘッダーコントロールの項目のインデックスを受け取るバッファーのアドレスへのポインター。インデックスは、項目が表示されている左から右の順で格納されます。
iCount
ヘッダーコントロールの項目数。負の値は指定できません。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

このメンバー関数は、Windows SDK に記述されている Win32 メッセージ HDM_GETORDERARRAY の動作を実装します。この関数は、ヘッダー項目の並べ替えをサポートするために提供されています。

使用例

      // Reverse the order of the items in the header control.
      // (i.e. make the first item the last one, the last item
      // the first one, and so on ...).
      int   nCount = m_myHeaderCtrl.GetItemCount();
      LPINT pnOrder = (LPINT) malloc(nCount*sizeof(int));
      ASSERT(pnOrder != NULL);
      if (NULL != pnOrder)
      {
         m_myHeaderCtrl.GetOrderArray(pnOrder, nCount);

         int i, j, nTemp;
         for (i=0, j=nCount-1; i < j; i++, j--)
         {
            nTemp = pnOrder[i];
            pnOrder[i] = pnOrder[j];
            pnOrder[j] = nTemp;
         }

         m_myHeaderCtrl.SetOrderArray(nCount, pnOrder);
         free(pnOrder);
      }