共用方式為

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。

rect
[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訊息傳送給色彩列控件的擁有者。

另請參閱

階層架構圖表
類別