CMFCRibbonCategory::SetCollapseOrder
更新 : 2007 年 11 月
リボン カテゴリのリボン パネルを折りたたむ順序を定義します。
void SetCollapseOrder(
const CArray<int,int>& arCollapseOrder
);
パラメータ
- [入力] arCollapseOrder
折りたたみ順序を指定します。この配列には、リボン パネルの 0 から始まるインデックスが格納されます。
解説
このライブラリは、折りたたみ順序を定義します。ただし、折りたたみ順序を示すインデックスのリストをカテゴリに指定することにより、この動作をカスタマイズできます。
カテゴリは、リボン パネルを折りたたむ必要があることを検出すると、指定されたリストの次の要素を探します。リストが空の場合、または十分な数の要素が指定されていない場合は、内部アルゴリズムが使用されます。
たとえば、カテゴリに 3 つのリボン パネルがあり、数回折りたたむとすべてのパネルが完全に折りたたまれた状態になるとします。この例では、折りたたみ順序 0, 0, 2, 2 を設定できます。この場合、パネル 0 が 2 回折りたたまれ、パネル 2 が 2 回折りたたまれます。インデックス 1 のパネルは、折りたたまれていない状態のままになります。
使用例
CMFCRibbonCategory クラスの SetCollapseOrder メソッドの使用方法を次の例に示します。この例では、折りたたみ順序の配列の構築方法と折りたたみ順序をリボン カテゴリに設定する方法を示しています。
CArray<int,int> arCollapseOrder;
arCollapseOrder.Add(0);
arCollapseOrder.Add(1);
arCollapseOrder.Add(2);
// CMFCRibbonCategory* pCategoryHome
pCategoryHome->SetCollapseOrder(arCollapseOrder);
必要条件
ヘッダー : afxribboncategory.h