Clase CMFCColorBarCMFCColorBar Class

La CMFCColorBar clase representa una barra de control de acoplamiento que puede seleccionar colores en un documento o aplicación.The CMFCColorBar class represents a docking control bar that can select colors in a document or application.

SintaxisSyntax

class CMFCColorBar : public CMFCPopupMenuBar

MiembrosMembers

Constructores protegidosProtected Constructors

NombreName DescripciónDescription
CMFCColorBar::CMFCColorBarCMFCColorBar::CMFCColorBar Construye un objeto CMFCColorBar.Constructs a CMFCColorBar object.

Métodos públicosPublic Methods

NOMBREName DescripciónDescription
CMFCColorBar::ContextToSizeCMFCColorBar::ContextToSize Calcula los márgenes vertical y horizontal necesarios para contener los botones del control de barra de color y, a continuación, ajusta la ubicación de esos botones.Calculates the vertical and horizontal margins that are required to contain the buttons on the color bar control and then adjusts the location of those buttons.
CMFCColorBar:: CreateControlCMFCColorBar::CreateControl Crea una ventana de control de barra de colores, la adjunta al CMFCColorBar objeto y cambia el tamaño del control para que contenga la paleta de colores especificada.Creates a color bar control window, attaches it to the CMFCColorBar object, and resizes the control to contain the specified palette of colors.
CMFCColorBar:: CreateCMFCColorBar::Create Crea una ventana de control de barra de colores y la adjunta al CMFCColorBar objeto.Creates a color bar control window and attaches it to the CMFCColorBar object.
CMFCColorBar::EnableAutomaticButtonCMFCColorBar::EnableAutomaticButton Muestra u oculta el botón automático.Shows or hides the automatic button.
CMFCColorBar::EnableOtherButtonCMFCColorBar::EnableOtherButton Habilita o deshabilita la presentación de un cuadro de diálogo que permite al usuario seleccionar más colores.Enables or disables the display of a dialog box that lets the user select more colors.
CMFCColorBar:: GetColorCMFCColorBar::GetColor Recupera el color seleccionado actualmente.Retrieves the currently selected color.
CMFCColorBar::GetCommandIDCMFCColorBar::GetCommandID Recupera el identificador de comando del control de barra de color actual.Retrieves the command ID of the current color bar control.
CMFCColorBar::GetHighlightedColorCMFCColorBar::GetHighlightedColor Recupera el color que significa que un botón de color tiene el foco. es decir, el botón está activo.Retrieves the color that signifies that a color button has the focus; that is, the button is hot.
CMFCColorBar::GetHorzMarginCMFCColorBar::GetHorzMargin Recupera el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.Retrieves the horizontal margin, which is the space between the left or right color cell and the client area boundary.
CMFCColorBar::GetVertMarginCMFCColorBar::GetVertMargin Recupera el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.Retrieves the vertical margin, which is the space between the top or bottom color cell and the client area boundary.
CMFCColorBar::IsTearOffCMFCColorBar::IsTearOff Indica si la barra de colores actual es acoplable.Indicates whether the current color bar is dockable.
CMFCColorBar:: SetColorCMFCColorBar::SetColor Establece el color seleccionado actualmente.Sets the color that is currently selected.
CMFCColorBar::SetColorNameCMFCColorBar::SetColorName Establece un nuevo nombre para el color especificado.Sets a new name for a specified color.
CMFCColorBar::SetCommandIDCMFCColorBar::SetCommandID Establece un nuevo identificador de comando para un control de barra de colores.Sets a new command ID for a color bar control.
CMFCColorBar::SetDocumentColorsCMFCColorBar::SetDocumentColors Establece la lista de colores que se usan en el documento actual.Sets the list of colors that are used in the current document.
CMFCColorBar::SetHorzMarginCMFCColorBar::SetHorzMargin Establece el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.Sets the horizontal margin, which is the space between the left or right color cell and the client area boundary.
CMFCColorBar::SetVertMarginCMFCColorBar::SetVertMargin Establece el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.Sets the vertical margin, which is the space between the top or bottom color cell and the client area boundary.

Métodos protegidosProtected Methods

NombreName DescripciónDescription
CMFCColorBar::AdjustLocationsCMFCColorBar::AdjustLocations Ajusta las posiciones de los botones de color en el control de barra de colores.Adjusts the positions of the color buttons on the color bar control.
CMFCColorBar::AllowChangeTextLabelsCMFCColorBar::AllowChangeTextLabels Indica si la etiqueta de texto de los botones de color puede cambiar.Indicates whether the text label of color buttons can change.
CMFCColorBar::AllowShowOnListCMFCColorBar::AllowShowOnList Indica si el objeto de control de barra de colores puede aparecer en una lista de la barra de herramientas durante el proceso de personalización.Indicates whether the color bar control object can appear in a toolbar list during the customization process.
CMFCColorBar::CalcSizeCMFCColorBar::CalcSize Lo llama el marco de trabajo como parte del proceso de cálculo del diseño.Called by the framework as part of the layout calculation process.
CMFCColorBar::CreatePaletteCMFCColorBar::CreatePalette Inicializa una paleta con los colores de una matriz de colores especificada.Initializes a palette with the colors in a specified array of colors.
CMFCColorBar::GetColorGridSizeCMFCColorBar::GetColorGridSize Calcula el número de filas y columnas en la cuadrícula de un control de barra de colores.Calculates the number of rows and columns in the grid of a color bar control.
CMFCColorBar::GetExtraHeightCMFCColorBar::GetExtraHeight Calcula el alto adicional que la barra de colores actual requiere para mostrar elementos de la interfaz de usuario varios, como el otro botón, los colores del documento, etc.Calculates the additional height that the current color bar requires to display miscellaneous user interface elements such as the Other button, document colors, and so on.
CMFCColorBar::InitColorsCMFCColorBar::InitColors Inicializa una matriz de colores con los colores de una paleta especificada o la paleta predeterminada del sistema.Initializes an array of colors with the colors in a specified palette or the system default palette.
CMFCColorBar::OnKeyCMFCColorBar::OnKey Lo llama el marco de trabajo cuando un usuario presiona un botón del teclado.Called by the framework when a user presses a keyboard button.
CMFCColorBar::OnSendCommandCMFCColorBar::OnSendCommand Lo llama el marco de trabajo para cerrar una jerarquía de controles emergentes.Called by the framework to close a hierarchy of popup controls.
CMFCColorBar::OnUpdateCmdUICMFCColorBar::OnUpdateCmdUI Lo llama el marco de trabajo para habilitar o deshabilitar un elemento de la interfaz de usuario de un control de barra de colores antes de que se muestre el elemento.Called by the framework to enable or disable a user-interface item of a color bar control before the item is displayed.
CMFCColorBar::OpenColorDialogCMFCColorBar::OpenColorDialog Abre un cuadro de diálogo de color.Opens a color dialog box.
CMFCColorBar:: RebuildCMFCColorBar::Rebuild Vuelve a dibujar completamente el control de barra de color.Completely redraws the color bar control.
CMFCColorBar::SelectPaletteCMFCColorBar::SelectPalette Establece la paleta lógica del contexto de dispositivo especificado en la paleta del botón primario del control de barra de color actual.Sets the logical palette of the specified device context to the palette of the parent button of the current color bar control.
CMFCColorBar::SetPropListCMFCColorBar::SetPropList Establece el m_pWndPropList miembro de datos protegido en el puntero especificado a un control de cuadrícula de propiedades.Sets the m_pWndPropList protected data member to the specified pointer to a property grid control.
CMFCColorBar::ShowCommandMessageStringCMFCColorBar::ShowCommandMessageString Solicita a la ventana de marco que posee el control de barra de color que actualice la línea de mensaje en la barra de estado.Requests the frame window that owns the color bar control to update the message line in the status bar.

Miembros de datos protegidosProtected Data Members

NombreName DescripciónDescription
m_bInternal Un campo booleano que determina si se procesan los eventos del mouse.A Boolean field that determines whether mouse events are processed. Normalmente, los eventos del mouse se procesan cuando este campo es TRUE y el modo de personalización es FALSE.Typically, mouse events are processed when this field is TRUE and customization mode is FALSE.
m_bIsEnabled Un valor booleano que indica si un control está habilitado.A Boolean that indicates whether a control is enabled.
m_bIsTearOff Un valor booleano que indica si el control de barra de colores admite el acoplamiento.A Boolean that indicates whether the color bar control supports docking.
m_BoxSize Objeto CSize que especifica el tamaño de una celda en una cuadrícula de barra de colores.A CSize object that specifies the size of a cell in a color bar grid.
m_bShowDocColorsWhenDocked Un valor booleano que indica si se deben mostrar los colores del documento cuando se acopla la barra de colores.A Boolean that indicates whether to show document colors when the color bar is docked. Para obtener más información, vea CMFCColorBar:: SetDocumentColors.For more information, see CMFCColorBar::SetDocumentColors.
m_bStdColorDlg Un valor booleano que indica si se debe mostrar el cuadro de diálogo color estándar del sistema o el cuadro de diálogo CMFCColorDialog .A Boolean that indicates whether to show the standard system color dialog box or the CMFCColorDialog dialog box. Para obtener más información, vea CMFCColorBar:: EnableOtherButton.For more information, see CMFCColorBar::EnableOtherButton.
m_ColorAutomatic COLORREF que almacena el color automático actual.A COLORREF that stores the current automatic color. Para obtener más información, vea CMFCColorBar:: EnableOtherButton.For more information, see CMFCColorBar::EnableOtherButton.
m_ColorNames Objeto CMAP que asocia un conjunto de colores RGB a sus nombres.An CMap object that associates a set of RGB colors with their names.
m_colors CArray de valores COLORREF que contiene los colores que se muestran en el control de barra de color.A CArray of COLORREF values that contains the colors that are displayed in the color bar control.
m_ColorSelected Un valor COLORREF que es el color que el usuario ha seleccionado actualmente en el control de barra de colores.A COLORREF value that is the color that the user has currently selected from the color bar control.
m_lstDocColors CList de valores COLORREF que contiene los colores utilizados actualmente en un documento.A CList of COLORREF values that contains the colors that are currently used in a document.
m_nCommandID Entero sin signo que es el identificador de comando de un botón de color.An unsigned integer that is the command ID of a color button.
m_nHorzMargin Un entero que es el margen horizontal entre los botones de color de una cuadrícula de colores.An integer that is the horizontal margin between the color buttons in a grid of colors.
m_nHorzOffset Entero que es el desplazamiento horizontal al centro del botón de color.An integer that is the horizontal offset to the center of the color button. Este valor es significativo si el botón muestra texto o una imagen además de un color.This value is significant if the button displays text or an image in addition to a color.
m_nNumColumns Un entero que es el número de columnas de una cuadrícula de controles de barra de colores.An integer that is the number of columns in a color bar control grid of colors.
m_nNumColumnsVert Entero que es el número de columnas de una cuadrícula de colores orientada verticalmente.An integer that is the number of columns in a vertically oriented grid of colors.
m_nNumRowsHorz Entero que es el número de columnas de una cuadrícula de colores orientada horizontalmente.An integer that is the number of columns in a horizontally oriented grid of colors.
m_nRowHeight Un entero que es el alto de una fila de botones de color en una cuadrícula de colores.An integer that is the height of a row of color buttons in a grid of colors.
m_nVertMargin Un entero que es el margen vertical entre los botones de color de una cuadrícula de colores.An integer that is the vertical margin between the color buttons in a grid of colors.
m_nVertOffset Entero que es el desplazamiento vertical hasta el centro del botón de color.An integer that is the vertical offset to the center of the color button. Este valor es significativo si el botón muestra texto o una imagen además de un color.This value is significant if the button displays text or an image in addition to a color.
m_Palette CPalette de los colores que se usan en el control de barra de color.A CPalette of the colors that are used in the color bar control.
m_pParentBtn Un puntero a un objeto CMFCColorButton que es el elemento primario del botón actual.A pointer to a CMFCColorButton object that is the parent of the current button. Este valor es significativo si el botón de color está en una jerarquía de controles de barra de herramientas o está en un control de cuadrícula de propiedades de color.This value is significant if the color button is in a hierarchy of toolbar controls or is in a color property grid control.
m_pParentRibbonBtn Un puntero a un objeto cmfcribboncolorbutton ( que se encuentra en la cinta de opciones y es el botón primario del botón actual.A pointer to a CMFCRibbonColorButton object that is on the ribbon and is the parent button of the current button. Este valor es significativo si el botón de color está en una jerarquía de controles de barra de herramientas o está en un control de cuadrícula de propiedades de color.This value is significant if the color button is in a hierarchy of toolbar controls or is in a color property grid control.
m_pWndPropList Un puntero a un objeto cmfcpropertygridctrl ( .A pointer to a CMFCPropertyGridCtrl object.
m_strAutoColor CString que es el texto que se muestra en el botón automático .A CString that is the text that is displayed on the Automatic button. Para obtener más información, vea CMFCColorBar:: EnableAutomaticButton.For more information, see CMFCColorBar::EnableAutomaticButton.
m_strDocColors CString que es el texto que se muestra en el botón colores del documento.A CString that is the text that is displayed on the document colors button. Para obtener más información, vea CMFCColorBar:: SetDocumentColors.For more information, see CMFCColorBar::SetDocumentColors.
m_strOtherColor CString que es el texto que se muestra en el botón otros .A CString that is the text that is displayed on the other button. Para obtener más información, vea CMFCColorBar:: EnableOtherButton.For more information, see CMFCColorBar::EnableOtherButton.

ObservacionesRemarks

Normalmente, no se crea un CMFCColorBar objeto directamente.Usually, you do not create a CMFCColorBar object directly. En su lugar, la clase CMFCColorMenuButton (que se usa en los menús y las barras de herramientas) o la clase CMFCColorButton crea el CMFCColorBar objeto.Instead, the CMFCColorMenuButton Class (used in menus and toolbars) or the CMFCColorButton Class creates the CMFCColorBar object.

La CMFCColorBar clase proporciona la funcionalidad siguiente:The CMFCColorBar class provides the following functionality:

  • Ajusta automáticamente la lista de colores del documento.Automatically adjusts the list of document colors.

  • Guarda y restaura su estado, junto con el estado del documento.Saves and restores its state, together with the document state.

  • Administra el botón "automático".Manages the "automatic" button.

  • Usa el control de clase CMFCColorPickerCtrl para seleccionar un color personalizado.Uses the CMFCColorPickerCtrl Class control to select a custom color.

  • Admite un estado "recortar" (si se crea mediante la clase CMFCColorMenuButton).Supports a "tear-off" state (if it is created by using the CMFCColorMenuButton Class).

Para incorporar la CMFCColorBar funcionalidad a la aplicación:To incorporate the CMFCColorBar functionality into your application:

  1. Cree un botón de menú normal y asígnele un identificador, por ejemplo ID_CHAR_COLOR.Create a regular menu button and assign it an ID, for example ID_CHAR_COLOR.

  2. En la clase de ventana de marco, invalide el método CFrameWndEx:: OnShowPopupMenu y reemplace el botón de menú normal por un objeto de clase CMFCColorMenuButton (llamando a CMFCToolBar:: ReplaceButton).In your frame window class, override the CFrameWndEx::OnShowPopupMenu method and replace the regular menu button with a CMFCColorMenuButton Class object (by calling CMFCToolBar::ReplaceButton).

  3. Establezca todos los estilos y habilite o deshabilite las características del CMFCColorBar objeto durante la creación de la clase CMFCColorMenuButton .Set all the styles and enable or disable the features of the CMFCColorBar object during CMFCColorMenuButton Class creation. El CMFCColorMenuButton objeto crea dinámicamente el CMFCColorBar objeto después de que el marco de trabajo llame al CreatePopupMenu método.The CMFCColorMenuButton object dynamically creates the CMFCColorBar object after the framework calls the CreatePopupMenu method.

Cuando el usuario hace clic en un botón de control de barra de colores, el marco de trabajo usa la ON_COMMAND macro para notificar al elemento primario del control de barra de color.When the user clicks a color bar control button, the framework uses the ON_COMMAND macro to notify the parent of the color bar control. En la macro, el parámetro de identificador de comando es el valor que asignó al botón de control de barra de color en el paso 1 (ID_CHAR_COLOR en este ejemplo).In the macro, the command ID parameter is the value that you assigned to the color bar control button in step 1 (ID_CHAR_COLOR in this example). Para obtener más información, vea la clase CMFCColorMenuButton, la clase CMFCColorButton, la clase CMFCColorPickerCtrl, la clase CFrameWndExy las clases de clase CMFCToolBar .For more information, see the CMFCColorMenuButton Class, CMFCColorButton Class, CMFCColorPickerCtrl Class, CFrameWndEx Class, and CMFCToolBar Class classes.

EjemploExample

En el ejemplo siguiente se muestra cómo configurar una barra de colores mediante el uso de varios métodos en la CMFCColorBar clase.The following example demonstrates how to configure a color bar by using various methods in the CMFCColorBar class. Los métodos establecen los márgenes horizontal y vertical, habilitan el otro botón, crean una ventana de control de barra de colores y establecen el color seleccionado actualmente.The methods set the horizontal and vertical margins, enable the other button, create a color bar control window, and sets the currently selected color. Este ejemplo forma parte del ejemplo de nuevos controles.This example is part of the New Controls sample.

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

Jerarquía de herenciaInheritance Hierarchy

CObjectCObject

CCmdTargetCCmdTarget

CWndCWnd

CBasePaneCBasePane

CPaneCPane

CMFCBaseToolBarCMFCBaseToolBar

CMFCToolBarCMFCToolBar

CMFCPopupMenuBarCMFCPopupMenuBar

CMFCColorBarCMFCColorBar

RequisitosRequirements

Encabezado: afxcolorbar. hHeader: afxcolorbar.h

CMFCColorBar::AdjustLocationsCMFCColorBar::AdjustLocations

Ajusta las posiciones de los botones de color en el control de barra de colores.Adjusts the positions of the color buttons on the color bar control.

virtual void AdjustLocations();

ObservacionesRemarks

El marco de trabajo llama a este método durante WM_SIZE procesamiento de mensajes.This method is called by the framework during WM_SIZE message processing.

CMFCColorBar::AllowChangeTextLabelsCMFCColorBar::AllowChangeTextLabels

Indica si la etiqueta de texto de los botones de color puede cambiar.Indicates whether the text label of color buttons can change.

virtual BOOL AllowChangeTextLabels() const;

Valor devueltoReturn Value

Siempre FALSE.Always FALSE.

ObservacionesRemarks

De forma predeterminada, este método siempre devuelve FALSE, lo que significa que no se pueden modificar las etiquetas de texto.By default, this method always returns FALSE, which means text labels cannot be modified. Invalide este método para habilitar la modificación de etiquetas de texto.Override this method to enable modifying text labels.

CMFCColorBar::AllowShowOnListCMFCColorBar::AllowShowOnList

Indica si el objeto de control de barra de colores puede aparecer en una lista de la barra de herramientas durante el proceso de personalización.Indicates whether the color bar control object can appear in a toolbar list during the customization process.

virtual BOOL AllowShowOnList() const;

Valor devueltoReturn Value

Siempre TRUE.Always TRUE.

ObservacionesRemarks

De forma predeterminada, este método siempre devuelve TRUE, lo que significa que el marco de trabajo puede mostrar el control de barra de color durante el proceso de personalización.By default, this method always returns TRUE, which means the framework can display the color bar control during the customization process. Invalide este método para implementar un comportamiento diferente.Override this method to implement a different behavior.

CMFCColorBar::CalcSizeCMFCColorBar::CalcSize

Lo llama el marco de trabajo como parte del proceso de cálculo del diseño.Called by the framework as part of the layout calculation process.

virtual CSize CalcSize(BOOL bVertDock);

ParámetrosParameters

bVertDockbVertDock
de TRUE para especificar que el control de barra de color está acoplado verticalmente. FALSE para especificar que el control de barra de color está acoplado horizontalmente.[in] TRUE to specify that the color bar control is docked vertically; FALSE to specify that the color bar control is docked horizontally.

Valor devueltoReturn Value

Tamaño de la matriz de botones de color de un control de barra de colores.The size of the array of color buttons in a color bar control.

CMFCColorBar::CMFCColorBarCMFCColorBar::CMFCColorBar

Construye un objeto CMFCColorBar.Constructs a CMFCColorBar object.

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

ParámetrosParameters

coloreacolors
de Matriz de colores que el marco muestra en el control de barra de colores.[in] An array of colors that the framework displays on the color bar control.

colorcolor
de El color seleccionado inicialmente.[in] The initially selected color.

lpszAutoColorlpszAutoColor
de La etiqueta de texto del botón de color automático (predeterminado) o null.[in] The text label of the automatic (default) color button, or NULL.

La etiqueta estándar del botón automático es automática.The standard label for the automatic button is Automatic.

lpszOtherColorlpszOtherColor
de La etiqueta de texto del botón otros , que muestra más opciones de color o null.[in] The text label of the other button, which displays more color choices, or NULL.

La etiqueta estándar para el otro botón es más colores....The standard label for the other button is More Colors....

lpszDocColorslpszDocColors
de La etiqueta de texto del botón colores del documento.[in] The text label of the document colors button. La paleta colores del documento muestra todos los colores que el documento utiliza actualmente.The document colors palette lists all the colors that the document currently uses.

lstDocColorslstDocColors
de Una lista de colores que el documento utiliza actualmente.[in] A list of colors that the document currently uses.

nColumnsnColumns
de El número de columnas que tiene la matriz de colores.[in] The number of columns that the array of colors has.

nRowsDockHorznRowsDockHorz
de Número de filas que tiene la barra de colores cuando está acoplada horizontalmente.[in] The number of rows that the color bar has when it is docked horizontally.

nColDockVertnColDockVert
de El número de columnas que tiene la barra de colores cuando está acoplada verticalmente.[in] The number of columns that the color bar has when it is docked vertically.

colorAutomaticcolorAutomatic
de El color predeterminado que el marco de trabajo aplica al hacer clic en el botón automático.[in] The default color that the framework applies when you click the automatic button.

nCommandIDnCommandID
de IDENTIFICADOR del comando de control de barra de color.[in] The color bar control command ID.

pParentBtnpParentBtn
de Un puntero a un botón primario.[in] A pointer to a parent button.

srcsrc
de Objeto existente CMFCColorBar que se va a copiar en el nuevo CMFCColorBar objeto.[in] An existing CMFCColorBar object to be copied into the new CMFCColorBar object.

uiCommandIDuiCommandID
de IDENTIFICADOR del comando.[in] The command ID.

CMFCColorBar::ContextToSizeCMFCColorBar::ContextToSize

Calcula los márgenes vertical y horizontal necesarios para contener los botones del control de barra de color y ajusta la ubicación de esos botones.Calculates the vertical and horizontal margins that are required to contain the buttons on the color bar control, and adjusts the location of those buttons.

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

ParámetrosParameters

bSquareButtonsbSquareButtons
de TRUE para especificar que la forma de los botones en un control de barra de color es cuadrada; en caso contrario, FALSE.[in] TRUE to specify that the shape of the buttons on a color bar control are square; otherwise, FALSE. El valor predeterminado es TRUE.The default value is TRUE.

bCenterButtonsbCenterButtons
de TRUE para especificar que el contenido de la superficie de un botón de control de barra de colores está centrado; en caso contrario, FALSE.[in] TRUE to specify that the content on the face of a color bar control button is centered; otherwise, FALSE. El valor predeterminado es TRUE.The default value is TRUE.

ObservacionesRemarks

CMFCColorBar:: CreateCMFCColorBar::Create

Crea una ventana de control de barra de colores y la adjunta al CMFCColorBar objeto.Creates a color bar control window and attaches it to the CMFCColorBar object.

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

ParámetrosParameters

pParentWndpParentWnd
de Puntero a la ventana primaria.[in] Pointer to the parent window.

dwStyledwStyle
de Combinación bit a bit (o) de estilos de ventana.[in] A bitwise combination (OR) of window styles.

nIDnID
de IDENTIFICADOR del comando.[in] The command ID.

pPalettepPalette
de Puntero a una paleta de colores.[in] Pointer to a palette of colors. El valor predeterminado es NULL.The default is NULL.

nColumnsnColumns
de El número de columnas del control de barra de color.[in] The number of columns in the color bar control. El valor predeterminado es 0.The default is 0.

nRowsDockHorznRowsDockHorz
de Número de filas del control de barra de color cuando se acopla horizontalmente.[in] The number of rows in the color bar control when it is docked horizontally. El valor predeterminado es 0.The default is 0.

nColDockVertnColDockVert
de El número de columnas del control de barra de color cuando está acoplada verticalmente.[in] The number of columns in the color bar control when it is docked vertically. El valor predeterminado es 0.The default is 0.

Valor devueltoReturn Value

TRUE si este método se realiza correctamente; en caso contrario, FALSE.TRUE if this method is successful; otherwise, FALSE.

ObservacionesRemarks

Para construir un CMFCColorBar objeto, llame al constructor de clase y, a continuación, a este método.To construct a CMFCColorBar object, call the class constructor then this method. El Create método crea el control de Windows e inicializa una lista de colores.The Create method creates the Windows control and initializes a list of colors.

CMFCColorBar:: CreateControlCMFCColorBar::CreateControl

Crea una ventana de control de barra de colores, la adjunta al CMFCColorBar objeto y cambia el tamaño de la ventana del control para que contenga la paleta de colores especificada.Creates a color bar control window, attaches it to the CMFCColorBar object, and resizes the control window to contain the specified palette of colors.

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

ParámetrosParameters

pParentWndpParentWnd
de Puntero a la ventana primaria.[in] Pointer to the parent window. No puede ser NULL.Cannot be NULL.

Rectrect
de Rectángulo delimitador que especifica dónde se debe dibujar el control de barra de color.[in] A bounding rectangle that specifies where to draw the color bar control.

nIDnID
de IDENTIFICADOR del control.[in] The control ID.

nColumnsnColumns
de Número ideal de columnas en el control de barra de color.[in] The ideal number of columns in the color bar control. Este método modifica ese número para ajustarse a la paleta de colores especificada.This method modifies that number to fit the specified palette of colors. El valor predeterminado es-1, lo que significa que no se especifica este parámetro.The default is -1, which means this parameter is not specified.

pPalettepPalette
de Puntero a una paleta de colores o NULL.[in] Pointer to a palette of colors, or NULL. Si este parámetro es NULL, este método calcula el tamaño del control de barra de color como si se hubieran 20 colores especificados.If this parameter is NULL, this method calculates the size of the color bar control as if 20 colors were specified. El valor predeterminado es NULL.The default is NULL.

Valor devueltoReturn Value

TRUE si este método se ejecuta correctamente; en caso contrario, FALSE.TRUE if this method succeeds; otherwise FALSE.

ObservacionesRemarks

Este método usa los parámetros Rect, nColumnsy pPalette para calcular el número o las filas y columnas adecuados en el control de barra de color y, a continuación, llama al método CMFCColorBar:: Create .This method uses the rect, nColumns, and pPalette parameters to calculate the appropriate number or rows and columns in the color bar control, and then calls the CMFCColorBar::Create method.

CMFCColorBar::CreatePaletteCMFCColorBar::CreatePalette

Inicializa una paleta con los colores de una matriz de colores especificada.Initializes a palette with the colors in a specified array of colors.

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

ParámetrosParameters

arColorsarColors
de Matriz de colores.[in] An array of colors.

índpalette
de Una paleta de colores.[in] A palette of colors.

Valor devueltoReturn Value

TRUE si este método se realiza correctamente; en caso contrario, FALSE.TRUE if this method is successful; otherwise, FALSE.

CMFCColorBar::EnableAutomaticButtonCMFCColorBar::EnableAutomaticButton

Muestra u oculta el botón automático.Shows or hides the automatic button.

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

ParámetrosParameters

lpszLabellpszLabel
de La etiqueta de texto del botón de color automático (predeterminado) o null.[in] The text label of the automatic (default) color button, or NULL.

La etiqueta estándar del botón automático es automática.The standard label for the automatic button is Automatic.

colorAutomaticcolorAutomatic
de El color predeterminado que el marco de trabajo aplica al hacer clic en el botón automático.[in] The default color that the framework applies when you click the automatic button.

bEnablebEnable
de TRUE para habilitar el botón automático; FALSE para deshabilitar el botón automático.[in] TRUE to enable the automatic button; FALSE to disable the automatic button. El valor predeterminado es TRUE.The default value is TRUE.

ObservacionesRemarks

Si el parámetro lpszLabel es null o el parámetro bEnable es false, se elimina la etiqueta de texto del botón automático.The text label of the automatic button is deleted if the lpszLabel parameter is NULL or the bEnable parameter is FALSE.

CMFCColorBar::EnableOtherButtonCMFCColorBar::EnableOtherButton

Habilita o deshabilita la presentación de un cuadro de diálogo que permite al usuario seleccionar más colores.Enables or disables the display of a dialog box that lets the user select more colors.

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

ParámetrosParameters

lpszLabellpszLabel
de La etiqueta de texto del botón otros , que muestra más opciones de color o null.[in] The text label of the other button, which displays more color choices, or NULL.

La etiqueta estándar para este botón es más colores....The standard label for this button is More Colors....

bAltColorDlgbAltColorDlg
de TRUE para mostrar el cuadro de diálogo CMFCColorDialog ; FALSE para mostrar el cuadro de diálogo CColorDialog estándar.[in] TRUE to display the CMFCColorDialog dialog box; FALSE to display the standard CColorDialog dialog box. El valor predeterminado es TRUE.The default value is TRUE.

bEnablebEnable
de TRUE para habilitar el botón; FALSE para deshabilitar el botón.[in] TRUE to enable the button; FALSE to disable the button. El valor predeterminado es TRUE.The default value is TRUE.

CMFCColorBar:: GetColorCMFCColorBar::GetColor

Recupera el color seleccionado actualmente.Retrieves the currently selected color.

COLORREF GetColor() const;

Valor devueltoReturn Value

El color seleccionado actualmente.The currently selected color.

CMFCColorBar::GetColorGridSizeCMFCColorBar::GetColorGridSize

Calcula el número de filas y columnas en la cuadrícula de un control de barra de colores.Calculates the number of rows and columns in the grid of a color bar control.

CSize GetColorGridSize(BOOL bVertDock) const;

ParámetrosParameters

bVertDockbVertDock
de TRUE para realizar el cálculo de un control de barra de colores acoplado verticalmente. de lo contrario, realice el cálculo para un control acoplado horizontalmente.[in] TRUE to perform the calculation for a vertically docked color bar control; otherwise, perform the calculation for a horizontally docked control.

Valor devueltoReturn Value

Un objeto CSize cuyo cx componente contiene el número de columnas y cuyo cy componente contiene el número de filas.A CSize object whose cx component contains the number of columns and whose cy component contains the number of rows.

CMFCColorBar::GetCommandIDCMFCColorBar::GetCommandID

Recupera el identificador de comando del control de barra de color actual.Retrieves the command ID of the current color bar control.

UINT GetCommandID() const;

Valor devueltoReturn Value

IDENTIFICADOR de comando.A command ID.

ObservacionesRemarks

Cuando el usuario selecciona un nuevo color, el marco de trabajo envía el identificador de comando en un mensaje de WM_COMMAND para notificar al elemento primario del CMFCColorBar objeto.When the user selects a new color, the framework sends the command ID in a WM_COMMAND message to notify the parent of the CMFCColorBar object.

CMFCColorBar::GetExtraHeightCMFCColorBar::GetExtraHeight

Calcula el alto adicional que la barra de colores actual requiere para mostrar los elementos de la interfaz de usuario varios, como los demás colores del botón o del documento.Calculates the additional height that the current color bar requires to display miscellaneous user interface elements, such as the Other button or document colors.

int GetExtraHeight(int nNumColumns) const;

ParámetrosParameters

nNumColumnsnNumColumns
de Si el control de barra de colores contiene los colores del documento, el número de columnas que se mostrarán en la cuadrícula de los colores del documento.[in] If the color bar control contains document colors, the number of columns to display in the grid of document colors. De lo contrario, este valor no se utiliza.Otherwise, this value is not used.

Valor devueltoReturn Value

Alto adicional calculado que se requiere.The calculated extra height that is required.

CMFCColorBar::GetHighlightedColorCMFCColorBar::GetHighlightedColor

Recupera el color que significa que un botón de color tiene el foco. es decir, el botón está activo.Retrieves the color that signifies that a color button has the focus; that is, the button is hot.

COLORREF GetHighlightedColor() const;

Valor devueltoReturn Value

Valor RGB.An RGB value.

ObservacionesRemarks

CMFCColorBar::GetHorzMarginCMFCColorBar::GetHorzMargin

Recupera el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.Retrieves the horizontal margin, which is the space between the left or right color cell and the client area boundary.

int GetHorzMargin();

Valor devueltoReturn Value

Margen horizontal.The horizontal margin.

CMFCColorBar::GetVertMarginCMFCColorBar::GetVertMargin

Recupera el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.Retrieves the vertical margin, which is the space between the top or bottom color cell and the client area boundary.

int GetVertMargin() const;

Valor devueltoReturn Value

Margen vertical.The vertical margin.

CMFCColorBar::InitColorsCMFCColorBar::InitColors

Inicializa una matriz de colores con los colores de una paleta especificada o con la paleta predeterminada del sistema.Initializes an array of colors with the colors in a specified palette, or with the system default palette.

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

ParámetrosParameters

pPalettepPalette
de Un puntero a un objeto Palette o NULL.[in] A pointer to a palette object, or NULL. Si este parámetro es NULL, este método utiliza la paleta predeterminada del sistema operativo.If this parameter is NULL, this method uses the default palette of the operating system.

arColorsarColors
de Matriz de colores.[in] An array of colors.

Valor devueltoReturn Value

Número de elementos de la matriz de colores.The number of elements in the array of colors.

CMFCColorBar::IsTearOffCMFCColorBar::IsTearOff

Indica si la barra de colores actual es acoplable.Indicates whether the current color bar is dockable.

BOOL IsTearOff() const;

Valor devueltoReturn Value

TRUE si el control de la barra de color actual es acoplable; en caso contrario, FALSE.TRUE if the current color bar control is dockable; otherwise, FALSE.

ObservacionesRemarks

Si el control de barra de color es acoplable, se puede desacoplar de una barra de controles y acoplarlo en otra ubicación.If the color bar control is dockable, it can be torn off a control bar and docked at another location.

CMFCColorBar::OnKeyCMFCColorBar::OnKey

Lo llama el marco de trabajo cuando un usuario presiona un botón del teclado.Called by the framework when a user presses a keyboard button.

virtual BOOL OnKey(UINT nChar);

ParámetrosParameters

nCharnChar
de Código de tecla virtual de la tecla que un usuario presionó.[in] The virtual-key code for the key that a user pressed.

Valor devueltoReturn Value

TRUE si este método procesa la clave especificada; en caso contrario, FALSE.TRUE if this method processes the specified key; otherwise, FALSE.

CMFCColorBar::OnSendCommandCMFCColorBar::OnSendCommand

Lo llama el marco de trabajo para cerrar una jerarquía de controles emergentes.Called by the framework to close a hierarchy of pop-up controls.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

ParámetrosParameters

pButtonpButton
de Puntero a un control que reside en una barra de herramientas.[in] Pointer to a control that resides on a toolbar.

Valor devueltoReturn Value

TRUE si este método se realiza correctamente; en caso contrario, FALSE.TRUE if this method is successful; otherwise, FALSE.

CMFCColorBar::OnUpdateCmdUICMFCColorBar::OnUpdateCmdUI

Lo llama el marco de trabajo para habilitar o deshabilitar un elemento de la interfaz de usuario de un control de barra de colores antes de que se muestre el elemento.Called by the framework to enable or disable a user-interface item of a color bar control before the item is displayed.

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

ParámetrosParameters

pTargetpTarget
de Puntero a una ventana que contiene un elemento de la interfaz de usuario que se va a actualizar.[in] Pointer to a window that contains a user-interface item to update.

bDisableIfNoHndlerbDisableIfNoHndler
de TRUE para deshabilitar el elemento de la interfaz de usuario si no hay ningún controlador definido en un mapa de mensajes; en caso contrario, FALSE.[in] TRUE to disable the user-interface item if no handler is defined in a message map; otherwise, FALSE.

ObservacionesRemarks

Cuando un usuario de la aplicación hace clic en un elemento de la interfaz de usuario, el elemento debe saber si debe mostrarse como habilitado o deshabilitado.When a user of your application clicks a user-interface item, the item must know whether it should be displayed as enabled or disabled. El destino del mensaje de comando proporciona esta información implementando un controlador de comandos de ON_UPDATE_COMMAND_UI.The target of the command message provides this information by implementing an ON_UPDATE_COMMAND_UI command handler. Utilice este método para ayudar a procesar el comando.Use this method to help process the command. Para obtener más información, vea CCmdUI (clase).For more information, see CCmdUI Class.

CMFCColorBar::OpenColorDialogCMFCColorBar::OpenColorDialog

Abre un cuadro de diálogo de color.Opens a color dialog box.

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

ParámetrosParameters

colorDefaultcolorDefault
de Color que está seleccionado de forma predeterminada cuando se abre el cuadro de diálogo color.[in] The color that is selected by default when the color dialog box opens.

colorRescolorRes
enuncia Color seleccionado por el usuario.[out] The color that a user selected.

Valor devueltoReturn Value

TRUE si el usuario seleccionó un color; FALSE si el usuario canceló el cuadro de diálogo de color.TRUE if the user selected a color; FALSE if the user canceled the color dialog box.

ObservacionesRemarks

CMFCColorBar:: RebuildCMFCColorBar::Rebuild

Vuelve a dibujar completamente el control de barra de color.Completely redraws the color bar control.

virtual void Rebuild();

CMFCColorBar::SelectPaletteCMFCColorBar::SelectPalette

Establece la paleta lógica del contexto de dispositivo especificado en la paleta del botón primario del control de barra de color actual.Sets the logical palette of the specified device context to the palette of the parent button of the current color bar control.

CPalette* SelectPalette(CDC* pDC);

ParámetrosParameters

ÉlpDC
de Puntero al contexto de dispositivo del botón primario del control de barra de color actual.[in] Pointer to the device context of the parent button of the current color bar control.

Valor devueltoReturn Value

Puntero a la paleta que se reemplaza por la paleta del botón primario del control de barra de color actual.Pointer to the palette that is replaced by the palette of the parent button of the current color bar control.

CMFCColorBar:: SetColorCMFCColorBar::SetColor

Establece el color seleccionado actualmente.Sets the color that is currently selected.

void SetColor(COLORREF color);

ParámetrosParameters

colorcolor
de Valor de color RGB.[in] An RGB color value.

CMFCColorBar::SetColorNameCMFCColorBar::SetColorName

Establece un nuevo nombre para el color especificado.Sets a new name for a specified color.

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

ParámetrosParameters

colorcolor
de Valor RGB de un color.[in] The RGB value of a color.

strNamestrName
de Nuevo nombre para el color especificado.[in] The new name for the specified color.

ObservacionesRemarks

Este método cambia el nombre del color especificado en todos los CMFCColorBar objetos de la aplicación.This method changes the name of the specified color in all CMFCColorBar objects in your application.

CMFCColorBar::SetCommandIDCMFCColorBar::SetCommandID

Establece un nuevo identificador de comando para un control de barra de colores.Sets a new command ID for a color bar control.

void SetCommandID(UINT nCommandID);

ParámetrosParameters

nCommandIDnCommandID
de IDENTIFICADOR de comando.[in] A command ID.

ObservacionesRemarks

Llame a este método para modificar el identificador de comando de un control de barra de color y para notificar a la ventana primaria del control que el identificador ha cambiado.Call this method to modify the command ID of a color bar control and to notify the parent window of the control that the ID has changed.

CMFCColorBar::SetDocumentColorsCMFCColorBar::SetDocumentColors

Establece la lista de colores que se usan en el documento actual.Sets the list of colors that are used in the current document.

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

ParámetrosParameters

lpszCaptionlpszCaption
de Título que se muestra cuando el control de barra de color no está acoplado.[in] A caption that is displayed when the color bar control is not docked.

lstDocColorslstDocColors
de Una lista de colores que reemplaza los colores del documento actual.[in] A list of colors that replaces the current document colors.

bShowWhenDockedbShowWhenDocked
de TRUE para mostrar los colores del documento cuando el control de barra de color está acoplado; en caso contrario, FALSE.[in] TRUE to show document colors when the color bar control is docked; otherwise, FALSE. El valor predeterminado es FALSE.The default value is FALSE.

ObservacionesRemarks

Los colores del documento son los colores que se usan actualmente en un documento.Document colors are the colors that are currently used in a document. El marco de trabajo mantiene automáticamente una lista de colores del documento, pero puede usar este método para modificar la lista.The framework automatically maintains a list of document colors, but you can use this method to modify the list.

CMFCColorBar::SetHorzMarginCMFCColorBar::SetHorzMargin

Establece el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.Sets the horizontal margin, which is the space between the left or right color cell and the boundary of the client area.

void SetHorzMargin(int nHorzMargin);

ParámetrosParameters

nHorzMarginnHorzMargin
de Margen horizontal, en píxeles.[in] The horizontal margin, in pixels.

ObservacionesRemarks

De forma predeterminada, el constructor CMFCColorBar:: CMFCColorBar establece el margen horizontal en 4 píxeles.By default, the CMFCColorBar::CMFCColorBar constructor sets the horizontal margin to 4 pixels.

CMFCColorBar::SetPropListCMFCColorBar::SetPropList

Establece el m_pWndPropList miembro de datos protegido en el puntero especificado a un control de cuadrícula de propiedades.Sets the m_pWndPropList protected data member to the specified pointer to a property grid control.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

ParámetrosParameters

pWndListpWndList
de Puntero al objeto de control de cuadrícula de propiedades.[in] Pointer to property grid control object.

CMFCColorBar::SetVertMarginCMFCColorBar::SetVertMargin

Establece el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.Sets the vertical margin, which is the space between the top or bottom color cell and the client area boundary.

void SetVertMargin(int nVertMargin);

ParámetrosParameters

nVertMarginnVertMargin
de Margen vertical, en píxeles.[in] The vertical margin, in pixels.

ObservacionesRemarks

De forma predeterminada, el constructor CMFCColorBar:: CMFCColorBar establece el margen vertical en 4 píxeles.By default, the CMFCColorBar::CMFCColorBar constructor sets the vertical margin to 4 pixels.

CMFCColorBar::ShowCommandMessageStringCMFCColorBar::ShowCommandMessageString

Solicita a la ventana de marco que posee el control de barra de color que actualice la línea de mensaje en la barra de estado.Requests the frame window that owns the color bar control to update the message line in the status bar.

virtual void ShowCommandMessageString(UINT uiCmdId);

ParámetrosParameters

uiCmdIduiCmdId
de IDENTIFICADOR de comando.[in] A command ID. (Este parámetro se pasa por alto).(This parameter is ignored.)

ObservacionesRemarks

Este método envía el mensaje de WM_SETMESSAGESTRING al propietario del control de barra de color.This method sends the WM_SETMESSAGESTRING message to the owner of the color bar control.

Consulte tambiénSee also

Gráfico de jerarquíaHierarchy Chart
ClasesClasses