分享方式：

CMFCColorBar 類別

  • 文章

類別 CMFCColorBar 代表可選取檔或應用程式中色彩的停駐控制列。

語法

class CMFCColorBar : public CMFCPopupMenuBar

成員

受保護的建構函式

名稱 描述
CMFCColorBar：：CMFCColorBar 建構 CMFCColorBar 物件。

公用方法

名稱 描述
CMFCColorBar：：CoNtextToSize 計算色彩列控制項上包含按鈕所需的垂直和水準邊界，然後調整這些按鈕的位置。
CMFCColorBar：：CreateControl 建立色彩列控制項視窗、將它附加至 CMFCColorBar 物件，並調整控制項的大小以包含指定的色彩調色盤。
CMFCColorBar：：Create 建立色彩列控制項視窗，並將它附加至 CMFCColorBar 物件。
CMFCColorBar：：EnableAutomaticButton 顯示或隱藏自動按鈕。
CMFCColorBar：：EnableOtherButton 啟用或停用對話方塊的顯示，讓使用者選取更多色彩。
CMFCColorBar：：GetColor 擷取目前選取的色彩。
CMFCColorBar：：GetCommandID 擷取目前色列控制項的命令識別碼。
CMFCColorBar：：GetHighlightedColor 擷取表示色彩按鈕具有焦點的色彩;也就是說，按鈕是 經常性存取 的。
CMFCColorBar：：GetHorzMargin 擷取水準邊界，也就是左右色彩儲存格與工作區界限之間的空間。
CMFCColorBar：：GetVertMargin 擷取垂直邊界，這是上色儲存格與工作區界限之間的空間。
CMFCColorBar：：IsTearOff 指出目前的色彩列是否可停駐。
CMFCColorBar：：SetColor 設定目前選取的色彩。
CMFCColorBar：：SetColorName 設定指定色彩的新名稱。
CMFCColorBar：：SetCommandID 設定色彩列控制項的新命令識別碼。
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 且自訂模式為 FALSE 時，會處理滑鼠事件。
m_bIsEnabled 布林值，指出控制項是否已啟用。
m_bIsTearOff 布林值，指出色條控制項是否支援停駐。
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 不帶正負號的整數，這是色彩按鈕的命令識別碼。
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 功能併入您的應用程式：

  1. 建立一般功能表按鈕，並為其指派識別碼，例如ID_CHAR_COLOR。

  2. 在您的框架視窗類別中 ，覆寫 CFrameWndEx：：OnShowPopupMenu 方法，並將一般功能表按鈕取代為 CMFCColorMenuButton 類別 物件（藉由呼叫 CMFCToolBar：：ReplaceButton ）。

  3. 設定所有樣式，並在建立 CMFCColorMenuButton 類別 期間 啟用或停用物件的功能 CMFCColorBar 。 物件 CMFCColorMenuButton 會在架構呼叫 CreatePopupMenu 方法之後動態建立 CMFCColorBar 物件。

當使用者按一下色彩列控制項按鈕時，架構會使用 ON_COMMAND 宏來通知色彩列控制項的父系。 在宏中，命令識別碼參數是您在步驟 1 中指派給色彩列控制項按鈕的值（在此範例中為ID_CHAR_COLOR）。 如需詳細資訊，請參閱 CMFCColorMenuButton 類別 、 CMFCColorButton 類別 、CMFCColorPickerCtrl 類別 、 CFrameWndEx 類別 和 CMFCToolBar 類別 類別。

範例

下列範例示範如何使用 類別中的 CMFCColorBar 各種方法來設定色彩列。 方法會設定水準和垂直邊界、啟用其他按鈕、建立色彩列控制項視窗，以及設定目前選取的色彩。 此範例是 New Controls 範例 的 一部分。

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

繼承階層架構

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

CMFCColorBar

需求

標頭： afxcolorbar.h

CMFCColorBar：：AdjustLocations

調整色彩列控制項上色彩按鈕的位置。

virtual void AdjustLocations();

備註

這個方法會在WM_SIZE訊息處理期間由架構呼叫。

CMFCColorBar：：AllowChangeTextLabels

指出色彩按鈕的文字標籤是否可以變更。

virtual BOOL AllowChangeTextLabels() const;

傳回值

一律為 FALSE。

備註

根據預設，此方法一律會傳回 FALSE，這表示無法修改文字標籤。 覆寫此方法以啟用修改文字標籤。

CMFCColorBar：：AllowShowOnList

指出色彩列控制項物件是否可以在自訂程式期間出現在工具列清單中。

virtual BOOL AllowShowOnList() const;

傳回值

一律為 TRUE。

備註

根據預設，此方法一律會傳回 TRUE，這表示架構可以在自訂程式期間顯示色彩列控制項。 覆寫此方法以實作不同的行為。

CMFCColorBar：：CalcSize

架構在版面配置計算程式中呼叫。

virtual CSize CalcSize(BOOL bVertDock);

參數

bVertDock
[in]TRUE 可指定色彩列控制項垂直停駐;FALSE 表示色彩列控制項水準停駐。

傳回值

色彩列控制項中色彩按鈕陣列的大小。

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]色彩列控制項命令識別碼。

pParentBtn
[in]父按鈕的指標。

src
[in]要複製到新 CMFCColorBar 物件的現有 CMFCColorBar 物件。

uiCommandID
[in]命令識別碼。

CMFCColorBar：：CoNtextToSize

計算包含色列控制項上按鈕所需的垂直和水準邊界，並調整這些按鈕的位置。

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

參數

bSquareButtons
[in]TRUE 表示指定色彩列控制項上按鈕的形狀是正方形的;否則為 FALSE。 預設值為 TRUE。

bCenterButtons
[in]TRUE 可指定色彩列控制項按鈕正面上的內容置中;否則為 FALSE。 預設值為 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
[in]命令識別碼。

pPalette
[in]色彩調色盤的指標。 預設值是 NULL。

nColumns
[in]色彩列控制項中的資料行數目。 預設值是 0。

nRowsDockHorz
[in]水準停駐時，色彩列控制項中的資料列數目。 預設值是 0。

nColDockVert
[in]垂直停駐時，色彩列控制項中的資料行數目。 預設值是 0。

傳回值

如果此方法成功，則為 TRUE;否則為 FALSE。

備註

若要建構 CMFCColorBar 物件，請呼叫 類別建構函式，然後呼叫這個方法。 方法 Create 會建立 Windows 控制項，並初始化色彩清單。

CMFCColorBar：：CreateControl

建立色彩列控制項視窗、將它附加至 CMFCColorBar 物件，以及調整控制項視窗的大小，以包含指定的色彩調色盤。

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

參數

pParentWnd
[in]父視窗的指標。 不可以是 NULL。

矩形
[in]周框，指定繪製色彩列控制項的位置。

nID
[in]控制項識別碼。

nColumns
[in]色彩列控制項中的理想欄數。 這個方法會修改該數位，以符合指定的色彩調色盤。 預設值為 -1，這表示未指定此參數。

pPalette
[in]色彩調色盤或 Null 的指標。 如果此參數為 Null，這個方法會計算色彩列控制項的大小，就像指定了 20 種色彩一樣。 預設值是 NULL。

傳回值

如果此方法成功，則為 TRUE;否則為 FALSE。

備註

此方法會使用 rect 、 nColumns 和 pPalette 參數來計算色彩列控制項中適當的數位或資料列和資料行，然後呼叫 CMFCColorBar：：Create 方法。

CMFCColorBar：：CreatePalette

使用指定之色彩陣列中的色彩，初始化調色盤。

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

參數

arColors
[in]色彩陣列。

調色板
[in]色彩調色盤。

傳回值

如果此方法成功，則為 TRUE;否則為 FALSE。

CMFCColorBar：：EnableAutomaticButton

顯示或隱藏自動按鈕。

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

參數

lpszLabel
[in]自動 （預設） 色彩按鈕的 文字標籤，或 Null。

自動按鈕的標準標籤為 [自動 ]。

colorAutomatic
[in]當您按一下自動按鈕時，架構套用的預設色彩。

bEnable
[in]TRUE 表示啟用自動按鈕;FALSE 可停用自動按鈕。 預設值為 TRUE。

備註

如果 lpszLabel 參數為 Null 或 bEnable 參數為 FALSE，就會刪除自動按鈕的 文字標籤。

CMFCColorBar：：EnableOtherButton

啟用或停用對話方塊的顯示，讓使用者選取更多色彩。

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

參數

lpszLabel
[in]另一個 按鈕的 文字標籤，其中顯示更多色彩選擇，或 Null。

此按鈕的標準標籤是 [更多色彩... ]。

bAltColorDlg
[in]TRUE 可顯示 [CMFCColorDialog ] 對話方塊;FALSE 以顯示標準 CColorDialog 對話方塊。 預設值為 TRUE。

bEnable
[in]TRUE 表示啟用按鈕;FALSE 可停用按鈕。 預設值為 TRUE。

CMFCColorBar：：GetColor

擷取目前選取的色彩。

COLORREF GetColor() const;

傳回值

目前選取的色彩。

CMFCColorBar：：GetColorGridSize

計算色彩列控制項方格中的資料列和資料行數目。

CSize GetColorGridSize(BOOL bVertDock) const;

參數

bVertDock
[in]TRUE 表示執行垂直停駐色彩列控制項的計算;否則，請執行水準停駐控制項的計算。

傳回值

CSize 物件，其 cx 元件包含資料行數目，而其 cy 元件包含資料列數目。

CMFCColorBar：：GetCommandID

擷取目前色列控制項的命令識別碼。

UINT GetCommandID() const;

傳回值

命令識別碼。

備註

當使用者選取新的色彩時，架構會在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;否則為 FALSE。

備註

如果色彩列控制項可停駐，它可以從控制列上拆開，並停駐在另一個位置。

CMFCColorBar：：OnKey

當使用者按下鍵盤按鈕時，由架構呼叫。

virtual BOOL OnKey(UINT nChar);

參數

nChar
[in]使用者按下之按鍵的虛擬按鍵程式碼。

傳回值

如果此方法處理指定的索引鍵，則為 TRUE;否則為 FALSE。

CMFCColorBar：：OnSendCommand

由架構呼叫以關閉快顯控制項的階層。

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

參數

pButton
[in]位於工具列上的控制項指標。

傳回值

如果此方法成功，則為 TRUE;否則為 FALSE。

CMFCColorBar：：OnUpdateCmdUI

由架構呼叫，以在顯示專案之前啟用或停用色列控制項的使用者介面專案。

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

參數

pTarget
[in]包含要更新之使用者介面專案的視窗指標。

bDisableIfNoHndler
[in]如果訊息對應中未定義任何處理程式，則為 TRUE，以停用使用者介面專案;否則為 FALSE。

備註

當您的應用程式使用者按一下使用者介面專案時，專案必須知道它是否應該顯示為已啟用或停用。 命令訊息的目標藉由實作ON_UPDATE_COMMAND_UI命令處理常式來提供這項資訊。 使用這個方法來協助處理命令。 如需詳細資訊，請參閱 CCmdUI 類別 。

CMFCColorBar：：OpenColorDialog

開啟色彩對話方塊。

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

參數

colorDefault
[in]色彩對話方塊開啟時預設選取的色彩。

colorRes
[out]使用者選取的色彩。

傳回值

如果使用者選取色彩，則為 TRUE;如果使用者取消色彩對話方塊，則為 FALSE。

備註

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

設定色彩列控制項的新命令識別碼。

void SetCommandID(UINT nCommandID);

參數

nCommandID
[in]命令識別碼。

備註

呼叫這個方法可修改色彩列控制項的命令識別碼，並通知控制項的父視窗識別碼已變更。

CMFCColorBar：：SetDocumentColors

設定目前檔中所使用的色彩清單。

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

參數

lpszCaption
[in]當色彩列控制項未停駐時顯示的標題。

lstDocColors
[in]取代目前檔色彩的色彩清單。

bShowWhenDocked
[in]TRUE 表示停駐色彩列控制項時顯示檔色彩;否則為 FALSE。 預設值為 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]命令識別碼。 （忽略此參數。

備註

這個方法會將WM_SETMESSAGESTRING訊息傳送給色彩列控制項的擁有者。

另請參閱

階層架構圖表
類別