CMFCColorBar クラス

[アーティクル]
10/12/2023

このクラスは CMFCColorBar 、ドキュメントまたはアプリケーションで色を選択できるドッキングコントロールバーを表します。

構文

class CMFCColorBar : public CMFCPopupMenuBar

メンバー

保護されたコンストラクター

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

パブリックメソッド

名前	説明
CMFCColorBar::ContextToSize	カラーバーコントロールのボタンを含めるために必要な垂直方向と水平方向の余白を計算し、それらのボタンの位置を調整します。
CMFCColorBar::CreateControl	カラーバーコントロールウィンドウを作成し、オブジェクトに `CMFCColorBar` アタッチし、コントロールのサイズを変更して、指定した色のパレットを含めます。
CMFCColorBar::Create	カラーバーコントロールウィンドウを作成し、オブジェクトに `CMFCColorBar` アタッチします。
CMFCColorBar::EnableAutomaticButton	自動ボタンを表示または非表示にします。
CMFCColorBar::EnableOtherButton	ユーザーがより多くの色を選択できるようにするダイアログボックスの表示を有効または無効にします。
CMFCColorBar::GetColor	現在選択されている色を取得します。
CMFCColorBar::GetCommandID	現在のカラーバーコントロールのコマンド ID を取得します。
CMFCColorBar::GetHighlightedColor	カラーボタンにフォーカスがあることを示す色を取得します。つまり、ボタンはホットです。
CMFCColorBar::GetHorzMargin	左右の色のセルとクライアント領域の境界の間のスペースである水平方向の余白を取得します。
CMFCColorBar::GetVertMargin	垂直方向の余白を取得します。これは、上または下の色のセルとクライアント領域の境界の間のスペースです。
CMFCColorBar::IsTearOff	現在のカラーバーがドッキング可能かどうかを示します。
CMFCColorBar::SetColor	現在選択されている色を設定します。
CMFCColorBar::SetColorName	指定した色の新しい名前を設定します。
CMFCColorBar::SetCommandID	カラーバーコントロールの新しいコマンド ID を設定します。
CMFCColorBar::SetDocumentColors	現在の文書で使用されている色の一覧を設定します。
CMFCColorBar::SetHorzMargin	左右の色のセルとクライアント領域の境界の間のスペースである水平方向の余白を設定します。
CMFCColorBar::SetVertMargin	垂直方向の余白を設定します。これは、上または下の色のセルとクライアント領域の境界の間のスペースです。

保護メソッド

名前	説明
CMFCColorBar::AdjustLocations	カラーバーコントロールのカラーボタンの位置を調整します。
CMFCColorBar::AllowChangeTextLabels	色ボタンのテキストラベルを変更できるかどうかを示します。
CMFCColorBar::AllowShowOnList	カスタマイズ処理中に、カラーバーコントロールオブジェクトをツールバーの一覧に表示できるかどうかを示します。
CMFCColorBar::CalcSize	レイアウト計算プロセスの一部としてフレームワークによって呼び出されます。
CMFCColorBar::CreatePalette	指定した色の配列内の色を使用してパレットを初期化します。
CMFCColorBar::GetColorGridSize	カラーバーコントロールのグリッド内の行と列の数を計算します。
CMFCColorBar::GetExtraHeight	[その他] ボタン、ドキュメントの色など、その他のユーザーインターフェイス要素を表示するために現在のカラーバーに必要な追加の高さを計算します。
CMFCColorBar::InitColors	指定したパレットまたはシステムの既定のパレットの色を使用して、色の配列を初期化します。
CMFCColorBar::OnKey	ユーザーがキーボードボタンを押したときにフレームワークによって呼び出されます。
CMFCColorBar::OnSendCommand	ポップアップコントロールの階層を閉じるには、フレームワークによって呼び出されます。
CMFCColorBar::OnUpdateCmdUI	項目が表示される前に、カラーバーコントロールのユーザーインターフェイス項目を有効または無効にするためにフレームワークによって呼び出されます。
CMFCColorBar::OpenColorDialog	[色] ダイアログボックスを開きます。
CMFCColorBar::Rebuild	カラーバーコントロールを完全に再描画します。
CMFCColorBar::SelectPalette	指定したデバイスコンテキストの論理パレットを、現在のカラーバーコントロールの親ボタンのパレットに設定します。
CMFCColorBar::SetPropList	保護されたデータメンバーを `m_pWndPropList` 、プロパティグリッドコントロールへの指定されたポインターに設定します。
CMFCColorBar::ShowCommandMessageString	ステータスバーのメッセージ行を更新するために、カラーバーコントロールを所有するフレームウィンドウを要求します。

プロテクトデータメンバー

名前	説明
`m_bInternal`	マウスイベントが処理されるかどうかを決定するブール型フィールド。通常、マウスイベントは、このフィールドが TRUE で、カスタマイズモードが FAL Standard Edition の場合に処理されます。
`m_bIsEnabled`	コントロールが有効かどうかを示すブール値。
`m_bIsTearOff`	カラーバーコントロールがドッキングをサポートしているかどうかを示すブール値。
`m_BoxSize`	カラーバーグリッド内のセルのサイズを指定する CSize オブジェクト。
`m_bShowDocColorsWhenDocked`	カラーバーがドッキングされたときにドキュメントの色を表示するかどうかを示すブール値。詳細については、「CMFCColorBar::SetDocumentColors」を参照してください。
`m_bStdColorDlg`	標準のシステムカラーダイアログボックスまたは CMFCColorDialog ダイアログボックスを表示するかどうかを示すブール値。詳細については、「CMFCColorBar::EnableOtherButton」を参照してください。
`m_ColorAutomatic`	現在の自動色を格納する COLORREF 。詳細については、「CMFCColorBar::EnableOtherButton」を参照してください。
`m_ColorNames`	RGB 色のセットを名前に関連付ける CMap オブジェクト。
`m_colors`	カラーバーコントロールに表示される色を含む COLORREF 値の CArray。
`m_ColorSelected`	ユーザーがカラーバーコントロールから現在選択している色を示す COLORREF 値です。
`m_lstDocColors`	ドキュメントで現在使用されている色を含む COLORREF 値の CList。
`m_nCommandID`	カラーボタンのコマンド ID である符号なし整数。
`m_nHorzMargin`	色のグリッド内の色ボタン間の水平方向の余白を表す整数。
`m_nHorzOffset`	カラーボタンの中心への水平方向のオフセットを表す整数。この値は、ボタンに色に加えてテキストまたは画像が表示される場合に重要です。
`m_nNumColumns`	カラーバーコントロールの色グリッド内の列数を表す整数。
`m_nNumColumnsVert`	垂直方向の色のグリッド内の列の数を表す整数。
`m_nNumRowsHorz`	水平方向の色のグリッド内の列の数を表す整数。
`m_nRowHeight`	色のグリッド内の色ボタンの行の高さを表す整数。
`m_nVertMargin`	色のグリッド内の色ボタン間の垂直方向の余白を表す整数。
`m_nVertOffset`	カラーボタンの中心への垂直方向のオフセットを表す整数。この値は、ボタンに色に加えてテキストまたは画像が表示される場合に重要です。
`m_Palette`	カラーバーコントロールで使用される色の CPalette。
`m_pParentBtn`	現在のボタンの親である CMFCColorButton オブジェクトへのポインター。この値は、カラーボタンがツールバーコントロールの階層内にある場合、またはカラープロパティグリッドコントロールにある場合に重要です。
`m_pParentRibbonBtn`	リボン上にあり、現在のボタンの親ボタンである CMFCRibbonColorButton オブジェクトへのポインター。この値は、カラーボタンがツールバーコントロールの階層内にある場合、またはカラープロパティグリッドコントロールにある場合に重要です。
`m_pWndPropList`	CMFCPropertyGridCtrl オブジェクトへのポインター。
`m_strAutoColor`	[自動] ボタンに表示されるテキストである CString。詳細については、「CMFCColorBar::EnableAutomaticButton」を参照してください。
`m_strDocColors`	ドキュメントの色ボタンに表示されるテキストである CString 。詳細については、「CMFCColorBar::SetDocumentColors」を参照してください。
`m_strOtherColor`	もう一方のボタンに表示されるテキストである CString。詳細については、「CMFCColorBar::EnableOtherButton」を参照してください。

解説

通常、オブジェクトは CMFCColorBar 直接作成しません。代わりに、 CMFCColorMenuButton クラス (メニューとツールバーで使用) または CMFCColorButton クラスによってオブジェクトが CMFCColorBar 作成されます。

このクラスには CMFCColorBar 、次の機能があります。

ドキュメントの色の一覧を自動的に調整します。
ドキュメントの状態と共にその状態を保存および復元します。
[自動] ボタンを管理します。
CMFCColorPickerCtrl クラスコントロールを使用して、ユーザー設定の色を選択します。
"破棄" 状態をサポートします (CMFCColorMenuButton クラスを使用して作成された場合)。

機能を CMFCColorBar アプリケーションに組み込むには、次の手順を実行します。

通常のメニューボタンを作成し、ID_CHAR_COLORなどの ID を割り当てます。
フレームウィンドウクラスで、CFrameWndEx::OnShowPopupMenu メソッドをオーバーライドし、標準メニューボタンを (CMFCToolBar::ReplaceButton を呼び出して) CMFCColorMenuButton クラスオブジェクトに置き換えます。
CMFCColorMenuButton クラスの作成時に、すべてのスタイルを設定し、CMFCColorBarオブジェクトの機能を有効または無効にします。オブジェクトは CMFCColorMenuButton 、フレームワークがメソッドを CMFCColorBar 呼び出した後に、オブジェクトを動的に CreatePopupMenu 作成します。

ユーザーがカラーバーコントロールボタンをクリックすると、フレームワークはマクロを ON_COMMAND 使用してカラーバーコントロールの親に通知します。マクロのコマンド ID パラメーターは、手順 1 でカラーバーコントロールボタンに割り当てた値です (この例ではID_CHAR_COLOR)。詳細については、CMFCColorMenuButton クラス、CMFCColorButton クラス、CMFCColorPickerCtrl クラス、CFrameWndEx クラス、および CMFCToolBar クラスクラスを参照してください。

例

次の例では、クラスのさまざまなメソッドを使用してカラーバーを構成する方法を CMFCColorBar 示します。このメソッドでは、水平方向と垂直方向の余白を設定し、もう一方のボタンを有効にして、カラーバーコントロールウィンドウを作成し、現在選択されている色を設定します。この例は、新しいコントロールのサンプルの一部です。

CMFCColorBar m_wndColorBar;

// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

継承階層

要件

ヘッダー: afxcolorbar.h

CMFCColorBar::AdjustLocations

カラーバーコントロールのカラーボタンの位置を調整します。

virtual void AdjustLocations();

解説

このメソッドは、メッセージ処理中にフレームワークWM_SIZE呼び出されます。

CMFCColorBar::AllowChangeTextLabels

色ボタンのテキストラベルを変更できるかどうかを示します。

virtual BOOL AllowChangeTextLabels() const;

戻り値

常に FALSE です。

解説

既定では、このメソッドは常に FAL Standard Edition を返します。これは、テキストラベルを変更できないことを意味します。テキストラベルの変更を有効にするには、このメソッドをオーバーライドします。

CMFCColorBar::AllowShowOnList

カスタマイズ処理中に、カラーバーコントロールオブジェクトをツールバーの一覧に表示できるかどうかを示します。

virtual BOOL AllowShowOnList() const;

戻り値

常に TRUE。

解説

既定では、このメソッドは常に TRUE を返します。つまり、フレームワークはカスタマイズプロセス中にカラーバーコントロールを表示できます。別の動作を実装するには、このメソッドをオーバーライドします。

CMFCColorBar::CalcSize

レイアウト計算プロセスの一部としてフレームワークによって呼び出されます。

virtual CSize CalcSize(BOOL bVertDock);

パラメーター

bVertDock
[in]色バーコントロールを垂直方向にドッキングすることを指定する場合は TRUE。FAL Standard Edition:カラーバーコントロールが水平方向にドッキングされるように指定します。

戻り値

カラーバーコントロール内のカラーボタンの配列のサイズ。

CMFCColorBar::CMFCColorBar

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

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

パラメーター

色
[in]フレームワークがカラーバーコントロールに表示する色の配列。

color
[in]最初に選択した色。

lpszAutoColor
[in]自動 (既定) 色ボタンのテキストラベル、または NULL。

自動ボタンの標準ラベルは自動です。

lpszOtherColor
[in]他のボタンのテキストラベル。より多くの色の選択肢が表示されます(NULL)。

もう一方のボタンの標準ラベルは[その他の色]...

lpszDocColors
[in]ドキュメントの色ボタンのテキストラベル。ドキュメントの色パレットには、ドキュメントで現在使用されているすべての色が一覧表示されます。

lstDocColors
[in]ドキュメントで現在使用されている色の一覧。

nColumns
[in]色の配列に含まれる列の数。

nRowsDockHorz
[in]カラーバーが水平方向にドッキングされたときの行数。

nColDockVert
[in]カラーバーが垂直方向にドッキングされたときに持つ列の数。

colorAutomatic
[in]自動ボタンをクリックしたときにフレームワークが適用する既定の色。

nCommandID
[in]カラーバーコントロールのコマンド ID。

pParentBtn
[in]親ボタンへのポインター。

src
[in]新しいCMFCColorBarオブジェクトにコピーする既存CMFCColorBarのオブジェクト。

uiCommandID
[入力] コマンド ID。

CMFCColorBar::ContextToSize

カラーバーコントロールのボタンを含めるために必要な垂直方向と水平方向の余白を計算し、それらのボタンの位置を調整します。

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

パラメーター

bSquareButtons
[in]TRUE は、カラーバーコントロールのボタンの図形が正方形であることを指定します。それ以外の場合は FAL Standard Edition。既定値は TRUE です。

bCenterButtons
[in]TRUE は、カラーバーコントロールボタンの面のコンテンツが中央に配置されることを指定します。それ以外の場合は FAL Standard Edition。既定値は TRUE です。

解説

CMFCColorBar::Create

カラーバーコントロールウィンドウを作成し、オブジェクトに CMFCColorBar アタッチします。

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

パラメーター

pParentWnd
[in]親ウィンドウへのポインター。

dwStyle
[in]ウィンドウスタイルのビットごとの組み合わせ (OR)。

nID
[入力] コマンド ID。

pPalette
[in]色のパレットへのポインター。の既定値は NULL です。

nColumns
[in]カラーバーコントロール内の列の数。既定値は 0 です。

nRowsDockHorz
[in]カラーバーコントロールが水平方向にドッキングされたときの行数。既定値は 0 です。

nColDockVert
[in]カラーバーコントロールが垂直方向にドッキングされたときの列の数。既定値は 0 です。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

オブジェクトを CMFCColorBar 構築するには、クラスコンストラクターを呼び出し、次にこのメソッドを呼び出します。このメソッドは Create 、Windows コントロールを作成し、色の一覧を初期化します。

CMFCColorBar::CreateControl

カラーバーコントロールウィンドウを作成し、オブジェクトに CMFCColorBar アタッチし、コントロールウィンドウのサイズを変更して、指定した色のパレットを含めます。

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

パラメーター

pParentWnd
[in]親ウィンドウへのポインター。 Nll は指定できません。

rect
[in]カラーバーコントロールを描画する場所を指定する外接する四角形。

nID
[入力] コントロール ID。

nColumns
[in]カラーバーコントロールの理想的な列数。このメソッドは、指定した色のパレットに合わせてその数を変更します。既定値は -1 です。これは、このパラメーターが指定されていないことを意味します。

pPalette
[in]色のパレット (NULL) へのポインター。このパラメーターが NULL の場合、このメソッドは 20 色が指定されたかのようにカラーバーコントロールのサイズを計算します。の既定値は NULL です。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

このメソッドは、rect、nColumns、および pPalette パラメーターを使用して、カラーバーコントロール内の適切な数または行と列を計算し、CMFCColorBar::Create メソッドを呼び出します。

CMFCColorBar::CreatePalette

指定した色の配列内の色を使用してパレットを初期化します。

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

パラメーター

arColors
[in]色の配列。

パレット
[in]色のパレット。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FAL Standard Edition。

CMFCColorBar::EnableAutomaticButton

自動ボタンを表示または非表示にします。

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

パラメーター

lpszLabel
[in]自動 (既定) 色ボタンのテキストラベル、または NULL。

自動ボタンの標準ラベルは自動です。

colorAutomatic
[in]自動ボタンをクリックしたときにフレームワークが適用する既定の色。

bEnable
[in]自動ボタンを有効にする場合は TRUE。FAL Standard Edition自動ボタンを無効にします。既定値は TRUE です。

解説

lpszLabel パラメーターが NULL または bEnable パラメーターが FAL Standard Edition の場合、自動ボタンのテキストラベルは削除されます。

CMFCColorBar::EnableOtherButton

ユーザーがより多くの色を選択できるようにするダイアログボックスの表示を有効または無効にします。

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

パラメーター

lpszLabel
[in]他のボタンのテキストラベル。より多くの色の選択肢が表示されます(NULL)。

このボタンの標準ラベルは [ その他の色]...

bAltColorDlg
[in]CMFCColorDialog ダイアログボックスを表示する場合は TRUE。FAL Standard Edition 標準の CColorDialog ダイアログボックスを表示します。既定値は TRUE です。

bEnable
[in]ボタンを有効にする場合は TRUE。FAL Standard Editionボタンを無効にします。既定値は TRUE です。

CMFCColorBar::GetColor

現在選択されている色を取得します。

COLORREF GetColor() const;

戻り値

現在選択されている色。

CMFCColorBar::GetColorGridSize

カラーバーコントロールのグリッド内の行と列の数を計算します。

CSize GetColorGridSize(BOOL bVertDock) const;

パラメーター

bVertDock
[in]垂直方向にドッキングされたカラーバーコントロールの計算を実行する場合は TRUE。それ以外の場合は、水平方向にドッキングされたコントロールの計算を実行します。

戻り値

コンポーネントに列の数がcx含まれており、そのコンポーネントに行数がcy含まれている CSize オブジェクト。

CMFCColorBar::GetCommandID

現在のカラーバーコントロールのコマンド ID を取得します。

UINT GetCommandID() const;

戻り値

コマンド ID。

解説

ユーザーが新しい色を選択すると、フレームワークはコマンド ID を WM_COMMAND メッセージに送信して、オブジェクトの CMFCColorBar 親に通知します。

CMFCColorBar::GetExtraHeight

[その他] ボタンやドキュメントの色など、その他のユーザーインターフェイス要素を表示するために現在のカラーバーに必要な追加の高さを計算します。

int GetExtraHeight(int nNumColumns) const;

パラメーター

nNumColumns
[in]カラーバーコントロールにドキュメントの色が含まれている場合は、ドキュメントの色のグリッドに表示する列の数。それ以外の場合、この値は使用されません。

戻り値

計算された追加の高さが必要です。

CMFCColorBar::GetHighlightedColor

カラーボタンにフォーカスがあることを示す色を取得します。つまり、ボタンはホットです。

COLORREF GetHighlightedColor() const;

戻り値

RGB 値。

解説

CMFCColorBar::GetHorzMargin

左右の色のセルとクライアント領域の境界の間のスペースである水平方向の余白を取得します。

int GetHorzMargin();

戻り値

水平方向の余白。

CMFCColorBar::GetVertMargin

垂直方向の余白を取得します。これは、上または下の色のセルとクライアント領域の境界の間のスペースです。

int GetVertMargin() const;

戻り値

垂直方向の余白。

CMFCColorBar::InitColors

指定したパレットの色またはシステムの既定のパレットを使用して、色の配列を初期化します。

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

パラメーター

pPalette
[in]パレットオブジェクトへのポインター、または NULL。このパラメーターが NULL の場合、このメソッドはオペレーティングシステムの既定のパレットを使用します。

arColors
[in]色の配列。

戻り値

色の配列内の要素の数。

CMFCColorBar::IsTearOff

現在のカラーバーがドッキング可能かどうかを示します。

BOOL IsTearOff() const;

戻り値

現在のカラーバーコントロールがドッキング可能な場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

カラーバーコントロールがドッキング可能な場合は、コントロールバーを引き裂いて別の場所にドッキングできます。

CMFCColorBar::OnKey

ユーザーがキーボードボタンを押したときにフレームワークによって呼び出されます。

virtual BOOL OnKey(UINT nChar);

パラメーター

nChar
[in]ユーザーが押したキーの仮想キーコード。

戻り値

このメソッドが指定したキーを処理する場合は TRUE。それ以外の場合は FAL Standard Edition。

CMFCColorBar::OnSendCommand

ポップアップコントロールの階層を閉じるには、フレームワークによって呼び出されます。

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

パラメーター

pButton
[in]ツールバーに存在するコントロールへのポインター。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FAL Standard Edition。

CMFCColorBar::OnUpdateCmdUI

項目が表示される前に、カラーバーコントロールのユーザーインターフェイス項目を有効または無効にするためにフレームワークによって呼び出されます。

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

パラメーター

pTarget
[in]更新するユーザーインターフェイス項目を含むウィンドウへのポインター。

bDisableIfNoHndler
[in]メッセージマップでハンドラーが定義されていない場合にユーザーインターフェイス項目を無効にする場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

アプリケーションのユーザーがユーザーインターフェイス項目をクリックすると、項目は有効または無効として表示される必要があるかどうかを認識する必要があります。コマンドメッセージのターゲットは、ON_UPDATE_COMMAND_UIコマンドハンドラーを実装することによってこの情報を提供します。このメソッドは、コマンドの処理に役立ちます。詳細については、「CCmdUI クラス」を参照してください。

CMFCColorBar::OpenColorDialog

[色] ダイアログボックスを開きます。

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

パラメーター

colorDefault
[in]色ダイアログボックスが開いたときに既定で選択される色。

colorRes
[out]ユーザーが選択した色。

戻り値

ユーザーが色を選択した場合は TRUE。FAL Standard Edition ユーザーが [色] ダイアログボックスを取り消した場合。

解説

CMFCColorBar::Rebuild

カラーバーコントロールを完全に再描画します。

virtual void Rebuild();

CMFCColorBar::SelectPalette

指定したデバイスコンテキストの論理パレットを、現在のカラーバーコントロールの親ボタンのパレットに設定します。

CPalette* SelectPalette(CDC* pDC);

パラメーター

pDC
[in]現在のカラーバーコントロールの親ボタンのデバイスコンテキストへのポインター。

戻り値

現在のカラーバーコントロールの親ボタンのパレットに置き換えられるパレットへのポインター。

CMFCColorBar::SetColor

現在選択されている色を設定します。

void SetColor(COLORREF color);

パラメーター

color
[in]RGB カラー値。

CMFCColorBar::SetColorName

指定した色の新しい名前を設定します。

static void SetColorName(
    COLORREF color,
    const CString& strName);

パラメーター

color
[in]色の RGB 値。

Strname
[in]指定した色の新しい名前。

解説

このメソッドは、アプリケーション内のすべての CMFCColorBar オブジェクトの指定された色の名前を変更します。

CMFCColorBar::SetCommandID

カラーバーコントロールの新しいコマンド ID を設定します。

void SetCommandID(UINT nCommandID);

パラメーター

nCommandID
[in]コマンド ID。

解説

カラーバーコントロールのコマンド ID を変更し、ID が変更されたことをコントロールの親ウィンドウに通知するには、このメソッドを呼び出します。

CMFCColorBar::SetDocumentColors

現在の文書で使用されている色の一覧を設定します。

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

パラメーター

lpszCaption
[in]カラーバーコントロールがドッキングされていないときに表示されるキャプション。

lstDocColors
[in]現在のドキュメントの色を置き換える色の一覧。

bShowWhenDocked
[in]TRUE を指定すると、カラーバーコントロールがドッキングされたときにドキュメントの色が表示されます。それ以外の場合は FAL Standard Edition。既定値は FALSE です。

解説

ドキュメントの色 は、ドキュメントで現在使用されている色です。フレームワークはドキュメントの色の一覧を自動的にメインしますが、このメソッドを使用してリストを変更できます。

CMFCColorBar::SetHorzMargin

左右の色のセルとクライアント領域の境界との間のスペースである水平方向の余白を設定します。

void SetHorzMargin(int nHorzMargin);

パラメーター

nHorzMargin
[in]水平方向の余白 (ピクセル単位)。

解説

既定では、 CMFCColorBar::CMFCColorBar コンストラクターは水平方向の余白を 4 ピクセルに設定します。

CMFCColorBar::SetPropList

保護されたデータメンバーを m_pWndPropList 、プロパティグリッドコントロールへの指定されたポインターに設定します。

void SetPropList(CMFCPropertyGridCtrl* pWndList);

パラメーター

pWndList
[in]プロパティグリッドコントロールオブジェクトへのポインター。

CMFCColorBar::SetVertMargin

垂直方向の余白を設定します。これは、上または下の色のセルとクライアント領域の境界の間のスペースです。

void SetVertMargin(int nVertMargin);

パラメーター

nVertMargin
[in]垂直方向の余白 (ピクセル単位)。

解説

既定では、 CMFCColorBar::CMFCColorBar コンストラクターは垂直方向の余白を 4 ピクセルに設定します。

CMFCColorBar::ShowCommandMessageString

ステータスバーのメッセージ行を更新するために、カラーバーコントロールを所有するフレームウィンドウを要求します。

virtual void ShowCommandMessageString(UINT uiCmdId);

パラメーター

uiCmdId
[in]コマンド ID。 (このパラメーターは無視されます)。

解説

このメソッドは、WM_Standard Edition TMESSAGESTRING メッセージをカラーバーコントロールの所有者に送信します。

Share via

CMFCColorBar クラス

構文

メンバー

保護されたコンストラクター

パブリック メソッド

保護メソッド

プロテクト データ メンバー

解説

例

継承階層

要件

CMFCColorBar::AdjustLocations

解説

CMFCColorBar::AllowChangeTextLabels

戻り値

解説

CMFCColorBar::AllowShowOnList

戻り値

解説

CMFCColorBar::CalcSize

パラメーター

戻り値

CMFCColorBar::CMFCColorBar

パラメーター

CMFCColorBar::ContextToSize

パラメーター

解説

CMFCColorBar::Create

パラメーター

戻り値

解説

CMFCColorBar::CreateControl

パラメーター

戻り値

解説

CMFCColorBar::CreatePalette

パラメーター

戻り値

CMFCColorBar::EnableAutomaticButton

パラメーター

解説

CMFCColorBar::EnableOtherButton

パラメーター

CMFCColorBar::GetColor

戻り値

CMFCColorBar::GetColorGridSize

パラメーター

戻り値

CMFCColorBar::GetCommandID

戻り値

解説

CMFCColorBar::GetExtraHeight

パラメーター

戻り値

CMFCColorBar::GetHighlightedColor

戻り値

解説

CMFCColorBar::GetHorzMargin

戻り値

CMFCColorBar::GetVertMargin

戻り値

CMFCColorBar::InitColors

パラメーター

戻り値

CMFCColorBar::IsTearOff

戻り値

解説

CMFCColorBar::OnKey

パラメーター

戻り値

CMFCColorBar::OnSendCommand

パラメーター

戻り値

CMFCColorBar::OnUpdateCmdUI

パラメーター

解説

CMFCColorBar::OpenColorDialog

パラメーター

戻り値

パブリックメソッド

プロテクトデータメンバー