通过

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 检索当前颜色条控件的命令 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 且自定义模式为 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 一个无符号整数，它是颜色按钮的命令 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 功能合并到应用程序中：

  1. 创建常规菜单按钮并为其分配 ID，例如 ID_CHAR_COLOR。

  2. 在框架窗口类中，重写 CFrameWndEx::OnShowPopupMenu 方法，并将常规菜单按钮替换为 CMFCColorMenuButton 类对象（通过调用 CMFCToolBar::ReplaceButton）。

  3. 设置所有样式，并在创建 CMFCColorBarCMFCColorMenuButton 类期间启用或禁用 对象的功能。 在框架调用 CreatePopupMenu 方法后，CMFCColorMenuButton 对象会动态创建 CMFCColorBar 对象。

当用户单击颜色条控件按钮时，框架使用 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));

继承层次结构

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

参数

colors
[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
[in] 命令 ID。

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] 命令 ID。

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] 控件 ID。

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] 颜色数组。

palette
[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

检索当前颜色条控件的命令 ID。

UINT GetCommandID() const;

返回值

命令 ID。

备注

当用户选择新颜色时，框架会在 WM_COMMAND 消息中发送命令 ID，以通知 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

设置颜色条控件的新命令 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 可在颜色条控件停靠时显示文档颜色；否则设置为 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] 命令 ID。 （忽略此参数。）

备注

此方法将 WM_SETMESSAGESTRING 消息发送给颜色条控件的所有者。

另请参阅

层次结构图
类