CMFCRibbonSeparator クラス
リボンの区切り記号を実装します。
構文
class CMFCRibbonSeparator : public CMFCRibbonBaseElement
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
| CMFCRibbonSeparator::CMFCRibbonSeparator | CMFCRibbonSeparator オブジェクトを構築します。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CMFCRibbonSeparator::AddToListBox | Customize ダイアログ ボックスの Commands リストに区切り記号を追加します。 ( をオーバーライドしますCMFCRibbonBaseElement::AddToListBox.) |
CMFCRibbonSeparator::CreateObject |
このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。 |
CMFCRibbonSeparator::GetThisClass |
このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するためにフレームワークによって使用されます。 |
保護メソッド
| 名前 | 説明 |
|---|---|
| CMFCRibbonSeparator::CopyFrom | 別のオブジェクトから区切り記号のメンバー変数を設定するコピー メソッド。 |
| CMFCRibbonSeparator::GetRegularSize | 区切り記号のサイズを返します。 |
| CMFCRibbonSeparator::IsSeparator | これが区切り記号かどうかを示します。 |
| CMFCRibbonSeparator::IsTabStop | これがタブ ストップかどうかを示します。 |
| CMFCRibbonSeparator::OnDraw | リボンまたはクイック アクセス ツール バーに区切り記号を描画するためにシステムによって呼び出されます。 |
| CMFCRibbonSeparator::OnDrawOnList | Commands リストに区切り記号を描画するためにシステムによって呼び出されます。 |
解説
リボン区切り記号は、リボン要素を論理的に区切る垂直線または水平線です。 区切り記号は、リボン コントロール、メイン アプリケーション メニュー、リボン ステータス バー、クイック アクセス ツール バーに描画できます。
アプリケーションで区切り記号を使用するには、次に示すように、新しいオブジェクトを作成し、メイン アプリケーション メニューに追加します。
CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
IDB_FILESMALL,
IDB_FILELARGE);
...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
CMFCRibbonPanel::AddSeparator を呼び出して、リボン パネルに区切り記号を追加します。 区切り記号は、 AddSeparator メソッドによって内部的に割り当てられ、追加されます。
継承階層
要件
ヘッダー: afxbaseribbonelement.h
CMFCRibbonSeparator::AddToListBox
Customize ダイアログ ボックスの Commands リストに区切り記号を追加します。
virtual int AddToListBox(
CMFCRibbonCommandsListBox* pWndListBox,
BOOL bDeep);
パラメーター
pWndListBox
[in]区切り記号が追加される Commands リストへのポインター。
bDeep
[in] 無視されます。
戻り値
pWndListBox で指定されたリスト ボックス内の文字列への 0 から始まるインデックス。
CMFCRibbonSeparator::CMFCRibbonSeparator
CMFCRibbonSeparator オブジェクトを構築します。
CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);
パラメーター
bIsHoriz
[in]TRUE の場合、区切り記号は水平方向です。FALSE の場合、区切り記号は垂直です。
解説
水平方向の区切り記号は、アプリケーション メニューで使用されます。 垂直区切り記号はツールバーで使用されます。
例
次の例では、 CMFCRibbonSeparator クラスのオブジェクトを構築する方法を示します。
// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
CMFCRibbonSeparator::CopyFrom
別のオブジェクトから区切り記号のメンバー変数を設定するコピー メソッド。
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
パラメーター
Src
[in]コピー元のリボン要素。
CMFCRibbonSeparator::GetRegularSize
区切り記号のサイズを返します。
virtual CSize GetRegularSize(CDC* pDC);
パラメーター
pDC
[in]デバイス コンテンツへのポインター。
戻り値
指定されたデバイス コンテキストの区切り記号のサイズ。
CMFCRibbonSeparator::IsSeparator
これが区切り記号かどうかを示します。
virtual BOOL IsSeparator() const;
戻り値
このクラスの場合は常に TRUE です。
CMFCRibbonSeparator::IsTabStop
これがタブ ストップかどうかを示します。
virtual BOOL IsTabStop() const;
戻り値
このクラスの場合は常に FALSE です。
解説
リボン区切り記号はタブ位置ではありません。
CMFCRibbonSeparator::OnDraw
リボンまたはクイック アクセス ツール バーに区切り記号を描画するためにシステムによって呼び出されます。
virtual void OnDraw(CDC* pDC);
パラメーター
pDC
[入力] デバイス コンテキストへのポインター。
CMFCRibbonSeparator::OnDrawOnList
Commands リストに区切り記号を描画するためにシステムによって呼び出されます。
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
パラメーター
pDC
[入力] デバイス コンテキストへのポインター。
strText
[in]リストに表示されるテキスト。
nTextOffset
[in]テキストと外接する四角形の左側の間隔。
rect
[in]外接する四角形を指定します。
bIsSelected
[in] 無視されます。
bHighlighted
[in] 無視されます。