CMFCColorBar 類別

發行項
02/28/2013

CMFCColorBar 類別表示可以選擇在文件或應用程式之色彩的內建的控制列。

class CMFCColorBar : public CMFCPopupMenuBar

Members

受保護的建構函式

名稱	描述
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	判斷的布林值 (Boolean) 欄位是否滑鼠事件處理常式。通常，滑鼠事件處理常式，在這個欄位是 TRUE 時，自訂方式是 FALSE。
m_bIsEnabled	布林 (Boolean) 值控制是否啟用。
m_bIsTearOff	布林值 (Boolean) 至色軸控制項是否支援停駐。
m_BoxSize	在 [色軸指定方格中的儲存格大小的 CSize 物件。
m_bShowDocColorsWhenDocked	指示是否顯示文件色彩的布林值，當呼叫色軸停駐。如需詳細資訊，請參閱 CMFCColorBar::SetDocumentColors。
m_bStdColorDlg	指示是否顯示標準系統色彩對話方塊或 CMFCColorDialog 對話方塊的布林值。如需詳細資訊，請參閱 CMFCColorBar::EnableOtherButton。
m_ColorAutomatic	儲存目前的自動色彩的 COLORREF 。如需詳細資訊，請參閱 CMFCColorBar::EnableOtherButton。
m_ColorNames	相關聯的一組物件的 CMap RGB 色彩與其名稱。
m_colors	的 COLORREF 值 CArray 包含色彩的色軸顯示控制項。
m_ColorSelected	色彩是使用者可以在色軸控制項中目前選取的 COLORREF 值。
m_lstDocColors	的 COLORREF 值 CList 包含色彩目前用於文件。
m_nCommandID	為色彩按鈕的命令 ID 的不帶正負號的整數。
m_nHorzMargin	是在色彩之間的水平框線的整數色彩在方格中。
m_nHorzOffset	為按鈕的中心色彩的水平位移的整數。除了之外，色彩，否則，請按一下按鈕顯示的文字或影像這個值是很重要的。
m_nNumColumns	是資料行數色彩的色軸控制項 ID 的整數。
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 類別提供了下列功能:

自動調整文件色彩清單。
與文件狀態一起儲存並還原其狀態。
處理「Auto」按鈕。
使用 CMFCColorPickerCtrl 類別控制選取自訂色彩。
(如果使用建立 CMFCColorMenuButton 類別)，支援「Tear-Off」狀態。

合併 CMFCColorBar 功能加入至您的應用程式:

建立一個規則功能表按鈕並指派其 ID，例如 ID_CHAR_COLOR。
在框架視窗類別中，覆寫方法 CFrameWndEx::OnShowPopupMenu 並以 CMFCColorMenuButton 類別物件取代規則功能表按鈕 (藉由呼叫 CMFCToolBar::ReplaceButton)。
將所有樣式並在 CMFCColorMenuButton 類別建立期間啟用或停用 CMFCColorBar 物件的功能。架構會呼叫 CreatePopupMenu 方法之後， CMFCColorMenuButton 物件動態建立 CMFCColorBar 物件。

當使用者按一下 [色軸控制項按鈕時，架構會使用 ON_COMMAND 巨集將告知色軸控制項的父代。在巨集，命令 ID 參數是您指派至步驟 1 的值 (在本例中為 ID_CHAR_COLOR 色軸按鈕控制項)。如需詳細資訊，請參閱 CMFCColorMenuButton 類別、 CMFCColorButton 類別、 CMFCColorPickerCtrl 類別、 CFrameWndEx 類別和 CMFCToolBar 類別類別。

範例

您可以使用類別，在 CMFCColorBar 的各種方法。下列範例將示範如何設定至色軸。方法設定層級，且垂直框線，讓另一個按鈕，建立對色軸控制 Windows 和集合目前所選取的色彩。這個範例是新的控制項範例的一部分。

    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));