CControlBar Class

[アーティクル]
09/26/2022

コントロールバークラス CStatusBar、CToolBar、CDialogBar、CReBar、および COleResizeBar の基本クラス。

構文

class CControlBar : public CWnd

メンバー

プロテクトコンストラクター

名前	説明
CControlBar::CControlBar	`CControlBar` オブジェクトを構築します。

パブリックメソッド

名前	説明
CControlBar::CalcDynamicLayout	動的コントロールバーのサイズを CSize オブジェクトとして返します。
CControlBar::CalcFixedLayout	コントロールバーのサイズを CSize オブジェクトとして返します。
CControlBar::CalcInsideRect	境界線を含むコントロールバー領域の現在のディメンションを返します。
CControlBar::D oPaint	コントロールバーの境界線およびグリップをレンダリングします。
CControlBar::D rawBorders	コントロールバーの境界線をレンダリングします。
CControlBar::D rawGripper	コントロールバーのグリップをレンダリングします。
CControlBar::EnableDocking	コントロールバーをドッキングまたはフローティングできるようにします。
CControlBar::GetBarStyle	コントロールバーのスタイル設定を取得します。
CControlBar::GetBorders	コントロールバーの境界線の値を取得します。
CControlBar::GetCount	コントロールバー内の HWND 以外の要素の数を返します。
CControlBar::GetDockingFrame	コントロールバーがドッキングされるフレームへのポインターを返します。
CControlBar::IsFloating	対象のコントロールバーがフローティングコントロールバーである場合に、ゼロ以外の値を返します。
CControlBar::OnUpdateCmdUI	コマンド UI ハンドラーを呼び出します。
CControlBar::SetBarStyle	コントロールバーのスタイル設定を変更します。
CControlBar::SetBorders	コントロールバーの境界線の値を設定します。
CControlBar::SetInPlaceOwner	コントロールバーのインプレース所有者を変更します。

パブリックデータメンバー

名前	説明
CControlBar::m_bAutoDelete	ゼロ以外の場合は、Windows のコントロールバーが破棄されると、`CControlBar` オブジェクトが削除されます。
CControlBar::m_pInPlaceOwner	コントロールバーのインプレース所有者です。

注釈

通常、コントロールバーは、フレームウィンドウの左側または右側にアラインされるウィンドウです。これには、HWND ベースのコントロール (Windows メッセージを生成して応答するウィンドウ)、またはウィンドウではなく、アプリケーションコードまたはフレームワークコードによって管理される HWND ベース以外の項目が含まれている場合があります。リストボックスと編集コントロールは、HWND ベースのコントロールの例です。ステータスバーペインとビットマップボタンは、HWND ベース以外のコントロールの例です。

通常、コントロールバーのウィンドウは親フレームウィンドウの子ウィンドウであり、通常はクライアントビューまたはフレームウィンドウの MDI クライアントの兄弟です。 CControlBar オブジェクトは、親ウィンドウのクライアント領域の四角形に関する情報を使用して、それ自体を配置します。次に、親ウィンドウのクライアント領域においてどの程度の未割り当て領域が残っているかについて、親ウィンドウに通知します。

CControlBar の詳細については、次を参照してください。

継承階層

CObject

CCmdTarget

CWnd

CControlBar

必要条件

ヘッダー: afxext.h

CControlBar::CalcDynamicLayout

フレームワークは、このメンバー関数を呼び出して、動的ツールバーのディメンションを計算します。

virtual CSize CalcDynamicLayout(
    int nLength,
    DWORD nMode);

パラメーター

nLength
dwMode に応じて、コントロールバーの水平方向または垂直方向の要求されたディメンション。

nMode
次の定義済みのフラグを使用して、動的コントロールバーの高さと幅を決定します。フラグを結合するには、ビットごとの OR (|) 演算子を使用します。

レイアウトモードフラグ	意味
LM_STRETCH	コントロールバーをフレームのサイズまで引き伸ばす必要があるかどうかを示します。バーがドッキングバーでない場合に設定します (ドッキングには使用できません)。バーがドッキングまたはフローティング (ドッキング可能) の場合は設定されません。設定した場合、LM_STRETCH は nLength を無視し、LM_HORZ状態に基づいてディメンションを返します。 LM_STRETCHは、CalcFixedLayout で使用される bStretch パラメーターと同様に動作します。ストレッチと向きの関係の詳細については、そのメンバー関数を参照してください。
LM_HORZ	バーが水平方向または垂直方向であることを示します。バーが水平方向の場合は設定され、垂直方向の場合は設定されません。 LM_HORZは、CalcFixedLayout で使用される bHorz パラメーターと同様に動作します。ストレッチと向きの関係の詳細については、そのメンバー関数を参照してください。
LM_MRUWIDTH	最近使用した動的幅。 nLength パラメーターを無視し、最近使用した幅を使用します。
LM_HORZDOCK	水平ドッキングされた寸法。 nLength パラメーターを無視し、幅が最も大きい動的サイズを返します。
LM_VERTDOCK	垂直ドッキングされた寸法。 nLength パラメーターを無視し、高さが最も大きい動的サイズを返します。
LM_LENGTHY	nLength が幅ではなく高さ (Y 方向) を示す場合に設定します。
LM_COMMIT	LM_MRUWIDTHをフローティングコントロールバーの現在の幅にリセットします。

戻り値

CSize オブジェクトのコントロールバーのサイズ (ピクセル単位)。

注釈

派生元 CControlBarのクラスで独自の動的レイアウトを提供するには、このメンバー関数をオーバーライドします。 CToolbar などの派生 MFC CControlBarクラスは、このメンバー関数をオーバーライドし、独自の実装を提供します。

CControlBar::CalcFixedLayout

コントロールバーの水平方向のサイズを計算するには、このメンバー関数を呼び出します。

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

パラメーター

bStretch
バーをフレームのサイズまで引き伸ばす必要があるかどうかを示します。 bStretch パラメーターは、バーがドッキングバーでない場合は 0 以外で (ドッキングには使用できません)、ドッキングまたはフローティング (ドッキングに使用できる) 場合は 0 です。

bHorz
バーが水平方向または垂直方向であることを示します。バーが水平方向の場合は bHorz パラメーターは 0 以外で、垂直方向の場合は 0 です。

戻り値

オブジェクトのコントロールバーの CSize サイズ (ピクセル単位)。

解説

ツールバーなどのコントロールバーは、コントロールバーに含まれるボタンに合わせて水平方向または垂直方向に伸ばすことができます。

bStretch が TRUE の場合は、bHorz によって提供される方向に沿ってディメンションを引き伸ばします。言い換えると、 bHorz が FALSE の場合、コントロールバーは垂直方向に引き伸ばされます。 bStretch が FALSE の場合、ストレッチは行われません。次の表は、 bStretch と bHorz の可能な順列と結果のコントロールバースタイルを示しています。

bStretch	bHorz	ストレッチ	方向	ドッキング/ドッキングしない
TRUE	TRUE	水平方向のストレッチ	水平方向	ドッキングしない
TRUE	FALSE	垂直方向のストレッチ	垂直方向	ドッキングしない
FALSE	TRUE	使用できるストレッチなし	水平方向	ドッキング
FALSE	FALSE	使用できるストレッチなし	垂直方向	ドッキング

CControlBar::CalcInsideRect

フレームワークはこの関数を呼び出して、コントロールバーのクライアント領域を計算します。

virtual void CalcInsideRect(
    CRect& rect,
    BOOL bHorz) const;

パラメーター

rect
コントロールバーの現在のディメンションを格納します。罫線を含みます。

bHorz
バーが水平方向または垂直方向であることを示します。バーが水平方向の場合は bHorz パラメーターは 0 以外で、垂直方向の場合は 0 です。

解説

この関数は、コントロールバーが描画される前に呼び出されます。

コントロールバーの境界線とグリッパーバーのレンダリングをカスタマイズするには、この関数をオーバーライドします。

CControlBar::CControlBar

CControlBar オブジェクトを構築します。

CControlBar();

CControlBar::D oPaint

コントロールバーの境界線とグリッパーバーをレンダリングするためにフレームワークによって呼び出されます。

virtual void DoPaint(CDC* pDC);

パラメーター

pDC
コントロールバーの境界線とグリッパーをレンダリングするために使用するデバイスコンテキストを指します。

解説

コントロールバーの描画動作をカスタマイズするには、この関数をオーバーライドします。

もう 1 つのカスタマイズ方法は、コントロールとDrawGripper関数をDrawBordersオーバーライドし、境界線とグリッパーのカスタム描画コードを追加することです。これらのメソッドは既定 DoPaint のメソッドによって呼び出されるため、オーバーライド DoPaint は必要ありません。

CControlBar::D rawBorders

コントロールバーの境界線をレンダリングするためにフレームワークによって呼び出されます。

virtual void DrawBorders(
    CDC* pDC,
    CRect& rect);

パラメーター

pDC
コントロールバーの境界線をレンダリングするために使用するデバイスコンテキストを指します。

rect
CRectコントロールバーの寸法を含むオブジェクト。

注釈

コントロールバーの境界線の外観をカスタマイズするには、この関数をオーバーライドします。

CControlBar::D rawGripper

コントロールバーのグリッパーをレンダリングするためにフレームワークによって呼び出されます。

virtual void DrawGripper(
    CDC* pDC,
    const CRect& rect);

パラメーター

pDC
コントロールバーグリッパーのレンダリングに使用するデバイスコンテキストを指します。

rect
CRectコントロールバーグリッパーの寸法を含むオブジェクト。

注釈

コントロールバーグリッパーの外観をカスタマイズするには、この関数をオーバーライドします。

CControlBar::EnableDocking

この関数を呼び出して、コントロールバーをドッキングできるようにします。

void EnableDocking(DWORD dwDockStyle);

パラメーター

dwDockStyle
コントロールバーがドッキングをサポートするかどうか、およびコントロールバーをドッキングできる親ウィンドウの辺 (サポートされている場合) を指定します。次のいずれかになります。

CBRS_ALIGN_TOP クライアント領域の上部にドッキングできます。
CBRS_ALIGN_BOTTOM クライアント領域の下部にドッキングできます。
CBRS_ALIGN_LEFT クライアント領域の左側にドッキングできます。
CBRS_ALIGN_RIGHT クライアント領域の右側にドッキングできます。
CBRS_ALIGN_ANY クライアント領域の任意の側にドッキングできます。
CBRS_FLOAT_MULTI 複数のコントロールバーを 1 つのミニフレームウィンドウに浮かび上がることができます。

0 (つまり、フラグがないことを示す) の場合、コントロールバーはドッキングされません。

解説

指定する辺は、移動先フレームウィンドウでのドッキングが有効になっているいずれかの辺と一致する必要があります。または、コントロールバーをそのフレームウィンドウにドッキングできません。

CControlBar::GetBarStyle

この関数を呼び出して、コントロールバーに対して現在設定されている CBRS_ (コントロールバースタイル) の設定を決定します。

DWORD GetBarStyle();

戻り値

コントロールバーの現在 のCBRS_ (コントロールバースタイル) の設定。使用可能なスタイルの完全な一覧については、「 CControlBar::SetBarStyle 」を参照してください。

解説

WS_ (ウィンドウスタイル) スタイルを処理しません。

CControlBar::GetBorders

コントロールバーの現在の境界線の値を返します。

CRect GetBorders() const;

戻り値

CRectコントロールバーオブジェクトの両側の現在の幅 (ピクセル単位) を含むオブジェクト。たとえば、CRect オブジェクトの左側のメンバーの値は、左側の境界線の幅です。

CControlBar::GetCount

オブジェクトの HWND 以外の項目の数を CControlBar 返します。

int GetCount() const;

戻り値

オブジェクト上の HWND 以外の項目の CControlBar 数。この関数は、CDialogBar オブジェクトに対して 0 を返します。

解説

項目の種類は、派生オブジェクト ( CStatusBar オブジェクトのペイン、 CToolBar オブジェクトのボタンと区切り記号) によって異なります。

CControlBar::GetDockingFrame

コントロールバーがドッキングされている現在のフレームウィンドウへのポインターを取得するには、このメンバー関数を呼び出します。

CFrameWnd* GetDockingFrame() const;

戻り値

成功した場合のフレームウィンドウへのポインター。それ以外の場合は NULL。

コントロールバーがフレームウィンドウにドッキングされていない場合 (つまり、コントロールバーがフローティングの場合)、この関数は親 CMiniFrameWnd へのポインターを返します。

解説

ドッキング可能なコントロールバーの詳細については、「 CControlBar::EnableDocking 」および「CFrameWnd::D ockControlBar」を参照してください。

CControlBar::IsFloating

コントロールバーがフローティングかドッキングかを判断するには、このメンバー関数を呼び出します。

BOOL IsFloating() const;

戻り値

コントロールバーがフローティングの場合は 0 以外。それ以外の場合は 0。

注釈

コントロールバーの状態をドッキングからフローティングに変更するには、 CFrameWnd::FloatControlBar を呼び出します。

CControlBar::m_bAutoDelete

ゼロ以外の場合は、Windows のコントロールバーが破棄されると、CControlBar オブジェクトが削除されます。

BOOL m_bAutoDelete;

解説

m_bAutoDelete は、BOOL 型のパブリック変数です。

通常、コントロールバーオブジェクトはフレームウィンドウオブジェクトに埋め込まれます。この場合、フレームウィンドウが破棄されると埋め込みコントロールバーオブジェクトが破棄されるため、 m_bAutoDelete は 0 になります。

ヒープにオブジェクトを割り当て CControlBar 、呼び出 deleteす予定がない場合は、この変数を 0 以外の値に設定します。

CControlBar::m_pInPlaceOwner

コントロールバーのインプレース所有者です。

CWnd* m_pInPlaceOwner;

CControlBar::OnUpdateCmdUI

このメンバー関数は、ツールバーまたはステータスバーの状態を更新するためにフレームワークによって呼び出されます。

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler) = 0;

パラメーター

pTarget
アプリケーションのメインフレームウィンドウをポイントします。このポインターは、更新メッセージのルーティングに使用されます。

bDisableIfNoHndler
更新ハンドラーを持たないコントロールを自動的に無効として表示するかどうかを示すフラグ。

解説

個々のボタンまたはウィンドウを更新するには、メッセージマップの ON_UPDATE_COMMAND_UI マクロを使用して、更新ハンドラーを適切に設定します。このマクロの使用方法の詳細については、 ON_UPDATE_COMMAND_UI を参照してください。

OnUpdateCmdUI は、アプリケーションがアイドル状態のときにフレームワークによって呼び出されます。更新するフレームウィンドウは、少なくとも間接的に、表示されるフレームウィンドウの子ウィンドウである必要があります。 OnUpdateCmdUI は高度なオーバーライド可能です。

CControlBar::SetBarStyle

コントロールバーに必要な CBRS_ スタイルを設定するには、この関数を呼び出します。

void SetBarStyle(DWORD dwStyle);

パラメーター

dwStyle
コントロールバーに必要なスタイル。次のいずれかになります。

CBRS_ALIGN_TOP コントロールバーをフレームウィンドウのクライアント領域の上部にドッキングできるようにします。
CBRS_ALIGN_BOTTOM コントロールバーをフレームウィンドウのクライアント領域の下部にドッキングできるようにします。
CBRS_ALIGN_LEFT コントロールバーをフレームウィンドウのクライアント領域の左側にドッキングできるようにします。
CBRS_ALIGN_RIGHT コントロールバーをフレームウィンドウのクライアント領域の右側にドッキングできるようにします。
CBRS_ALIGN_ANY コントロールバーをフレームウィンドウのクライアント領域の任意の側にドッキングできるようにします。
CBRS_BORDER_TOP コントロールバーが表示されるときに、コントロールバーの上端に境界線が描画されます。
CBRS_BORDER_BOTTOM コントロールバーが表示されるときに、コントロールバーの下端に境界線が描画されます。
CBRS_BORDER_LEFT コントロールバーが表示されるときに、コントロールバーの左端に境界線が描画されます。
CBRS_BORDER_RIGHT コントロールバーが表示されるときに、コントロールバーの右端に境界線が描画されます。
CBRS_FLOAT_MULTI 複数のコントロールバーを 1 つのミニフレームウィンドウに浮かび上がることができます。
CBRS_TOOLTIPS コントロールバーのツールヒントが表示されます。
CBRS_FLYBY ツールヒントと同時にメッセージテキストが更新されます。
CBRS_GRIPPER オブジェクト内のバンドで CReBar 使用されるグリッパーと同様に、グリッパーが任意 CControlBarの派生クラスに対して描画されます。

注釈

WS_ (ウィンドウスタイル) の設定には影響しません。

CControlBar::SetBorders

コントロールバーの境界線のサイズを設定するには、この関数を呼び出します。

void SetBorders(
    int cxLeft = 0,
    int cyTop = 0,
    int cxRight = 0,
    int cyBottom = 0);

void SetBorders(LPCRECT lpRect);

パラメーター

cxLeft
コントロールバーの左罫線の幅 (ピクセル単位)。

cyTop
コントロールバーの上罫線の高さ (ピクセル単位)。

cxRight
コントロールバーの右罫線の幅 (ピクセル単位)。

cyBottom
コントロールバーの下罫線の高さ (ピクセル単位)。

lpRect
コントロールバーオブジェクトの各境界線の現在の幅 (ピクセル単位) を含む CRect オブジェクトへのポインター。

例

次のコード例では、コントロールバーの上下の境界線を 5 ピクセルに、左右の境界線を 2 ピクセルに設定します。

CControlBar &m_myControlBar = m_Rebar;
m_myControlBar.SetBorders(2, 5, 2, 5);

CControlBar::SetInPlaceOwner

コントロールバーのインプレース所有者を変更します。

void SetInPlaceOwner(CWnd* pWnd);

パラメーター

pWnd
CWnd オブジェクトを指すポインターです。

CControlBar Class

構文

メンバー

プロテクト コンストラクター

パブリック メソッド

パブリック データ メンバー

注釈

継承階層

必要条件

CControlBar::CalcDynamicLayout

パラメーター

戻り値

注釈

CControlBar::CalcFixedLayout

パラメーター

戻り値

解説

CControlBar::CalcInsideRect

パラメーター

解説

CControlBar::CControlBar

CControlBar::D oPaint

パラメーター

解説

CControlBar::D rawBorders

パラメーター

注釈

CControlBar::D rawGripper

パラメーター

注釈

CControlBar::EnableDocking

パラメーター

解説

CControlBar::GetBarStyle

戻り値

解説

CControlBar::GetBorders

戻り値

CControlBar::GetCount

戻り値

解説

CControlBar::GetDockingFrame

戻り値

解説

CControlBar::IsFloating

戻り値

注釈

CControlBar::m_bAutoDelete

解説

CControlBar::m_pInPlaceOwner

CControlBar::OnUpdateCmdUI

パラメーター

解説

CControlBar::SetBarStyle

パラメーター

注釈

CControlBar::SetBorders

パラメーター

例

CControlBar::SetInPlaceOwner

パラメーター

解説

関連項目

その他のリソース

その他のリソース

プロテクトコンストラクター

パブリックメソッド

パブリックデータメンバー