Clase CMFCColorBar

Artículo
06/16/2023

La clase CMFCColorBar representa una barra de controles de acoplamiento que puede seleccionar colores en un documento o una aplicación.

Sintaxis

class CMFCColorBar : public CMFCPopupMenuBar

Miembros

Constructores protegidos

Nombre	Descripción
CMFCColorBar::CMFCColorBar	Construye un objeto `CMFCColorBar`.

Métodos públicos

Nombre	Descripción
CMFCColorBar::ContextToSize	Calcula los márgenes verticales y horizontales necesarios para contener los botones del control de barra de colores y, a continuación, ajusta la ubicación de esos botones.
CMFCColorBar::CreateControl	Crea una ventana de control de barra de colores, la adjunta al objeto `CMFCColorBar` y cambia el tamaño del control para que contenga la paleta de colores especificada.
CMFCColorBar::Create	Crea una ventana de control de barra de colores y la adjunta al objeto `CMFCColorBar`.
CMFCColorBar::EnableAutomaticButton	Muestra u oculta el botón automático.
CMFCColorBar::EnableOtherButton	Habilita o deshabilita la presentación de un cuadro de diálogo que permite al usuario seleccionar más colores.
CMFCColorBar::GetColor	Recupera el color seleccionado actualmente.
CMFCColorBar::GetCommandID	Recupera el identificador de comando del control de barra de colores actual.
CMFCColorBar::GetHighlightedColor	Recupera el color que indica que un botón de color tiene el foco; es decir, el botón está activo.
CMFCColorBar::GetHorzMargin	Recupera el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.
CMFCColorBar::GetVertMargin	Recupera el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.
CMFCColorBar::IsTearOff	Indica si la barra de color actual es acoplable.
CMFCColorBar::SetColor	Establece el color seleccionado actualmente.
CMFCColorBar::SetColorName	Establece un nuevo nombre para el color especificado.
CMFCColorBar::SetCommandID	Establece un nuevo identificador de comando para un control de barra de colores.
CMFCColorBar::SetDocumentColors	Establece la lista de colores que se usan en el documento actual.
CMFCColorBar::SetHorzMargin	Establece el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.
CMFCColorBar::SetVertMargin	Establece el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.

Métodos protegidos

Nombre	Descripción
CMFCColorBar::AdjustLocations	Ajusta las posiciones de los botones de color en el control de barra de colores.
CMFCColorBar::AllowChangeTextLabels	Indica si la etiqueta de texto de los botones de color puede cambiar.
CMFCColorBar::AllowShowOnList	Indica si el objeto de control de barra de colores puede aparecer en una lista de barras de herramientas durante el proceso de personalización.
CMFCColorBar::CalcSize	Lo llama el marco como parte del proceso de cálculo de diseño.
CMFCColorBar::CreatePalette	Inicializa una paleta con los colores de una matriz de colores especificada.
CMFCColorBar::GetColorGridSize	Calcula el número de filas y columnas de la cuadrícula de un control de barra de colores.
CMFCColorBar::GetExtraHeight	Calcula el alto adicional que requiere la barra de colores actual para mostrar varios elementos de la interfaz de usuario, como el botón Otros, los colores de documento, etc.
CMFCColorBar::InitColors	Inicializa una matriz de colores con los colores de una paleta especificada o la paleta predeterminada del sistema.
CMFCColorBar::OnKey	Lo llama el marco de trabajo cuando un usuario pulsa un botón de teclado.
CMFCColorBar::OnSendCommand	Lo llama el marco de trabajo para cerrar una jerarquía de controles emergentes.
CMFCColorBar::OnUpdateCmdUI	Lo llama el marco de trabajo para habilitar o deshabilitar un elemento de interfaz de usuario de un control de barra de colores antes de que se muestre el elemento.
CMFCColorBar::OpenColorDialog	Abre un cuadro de diálogo de color.
CMFCColorBar::Rebuild	Vuelve a dibujar completamente el control de barra de colores.
CMFCColorBar::SelectPalette	Establece la paleta lógica del contexto de dispositivo especificado en la paleta del botón primario del control de barra de colores actual.
CMFCColorBar::SetPropList	Establece el miembro de datos protegido `m_pWndPropList` en el puntero especificado a un control de cuadrícula de propiedades.
CMFCColorBar::ShowCommandMessageString	Solicita a la ventana de marco que posee el control de barra de colores que actualice la línea de mensajes en la barra de estado.

Miembros de datos protegidos

Nombre	Descripción
`m_bInternal`	Campo booleano que determina si se procesan los eventos del mouse. Normalmente, los eventos del mouse se procesan cuando este campo es TRUE y el modo de personalización es FALSE.
`m_bIsEnabled`	Valor booleano que indica si un control está habilitado.
`m_bIsTearOff`	Valor booleano que indica si el control de barra de colores admite acoplamiento.
`m_BoxSize`	Objeto CSize que especifica el tamaño de una celda en una cuadrícula de barra de colores.
`m_bShowDocColorsWhenDocked`	Valor booleano que indica si se muestran los colores de documento cuando la barra de colores está acoplada. Para obtener más información, consulte CMFCColorBar::SetDocumentColors.
`m_bStdColorDlg`	Valor booleano que indica si se va a mostrar el cuadro de diálogo de color del sistema estándar o el cuadro de diálogo CMFCColorDialog. Para obtener más información, consulte CMFCColorButton::EnableOtherButton.
`m_ColorAutomatic`	Elemento COLORREF que almacena el color automático actual. Para obtener más información, consulte CMFCColorButton::EnableOtherButton.
`m_ColorNames`	Objeto CMap que asocia un conjunto de colores RGB con sus nombres.
`m_colors`	Objeto CArray de valores COLORREF que contiene los colores que se muestran en el control de barra de colores.
`m_ColorSelected`	Valor de tipo COLORREF que es el color que el usuario ha seleccionado actualmente en el control de barra de colores.
`m_lstDocColors`	Objeto CList de valores COLORREF que contiene los colores que se usan actualmente en un documento.
`m_nCommandID`	Entero sin signo que es el identificador de comando de un botón de color.
`m_nHorzMargin`	Entero que es el margen horizontal entre los botones de color de una cuadrícula de colores.
`m_nHorzOffset`	Entero que es el desplazamiento horizontal al centro del botón de color. Este valor es significativo si el botón muestra texto o una imagen además de un color.
`m_nNumColumns`	Entero que es el número de columnas de una cuadrícula de controles de barra de colores.
`m_nNumColumnsVert`	Entero que es el número de columnas de una cuadrícula de colores orientada verticalmente.
`m_nNumRowsHorz`	Entero que es el número de columnas de una cuadrícula de colores orientada horizontalmente.
`m_nRowHeight`	Entero que es el alto de una fila de botones de color en una cuadrícula de colores.
`m_nVertMargin`	Entero que es el margen vertical entre los botones de color de una cuadrícula de colores.
`m_nVertOffset`	Entero que es el desplazamiento vertical al centro del botón de color. Este valor es significativo si el botón muestra texto o una imagen además de un color.
`m_Palette`	Objeto CPalette de los colores que se usan en el control de barra de colores.
`m_pParentBtn`	Puntero a un objeto CMFCColorButton que es el elemento primario del botón actual. 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.
`m_pParentRibbonBtn`	Puntero a un objeto CMFCRibbonColorButton que se encuentra en la cinta de opciones y es el botón primario del botón actual. 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.
`m_pWndPropList`	Puntero a un objeto CMFCPropertyGridCtrl.
`m_strAutoColor`	Elemento CString que es el texto que se muestra en el botón Automático. Para obtener más información, consulte CMFCColorBar::EnableAutomaticButton.
`m_strDocColors`	Elemento CString que es el texto que se muestra en el botón de colores de documento. Para obtener más información, consulte CMFCColorBar::SetDocumentColors.
`m_strOtherColor`	Elemento CString que es el texto que se muestra en el otro botón. Para obtener más información, consulte CMFCColorButton::EnableOtherButton.

Comentarios

Normalmente, no se crea un objeto CMFCColorBar directamente. En su lugar, la clase CMFCColorMenuButton (usada en menús y barras de herramientas) o la clase CMFCColorButton crean el objeto CMFCColorBar.

La clase CMFCColorBar proporciona la siguiente funcionalidad:

Ajusta automáticamente la lista de colores de documento.
Guarda y restaura su estado, junto con el estado del documento.
Administra el botón "automático".
Usa el control de la clase CMFCColorPickerCtrl para seleccionar un color personalizado.
Admite un estado "acoplable" (si se crea mediante la clase CMFCColorMenuButton).

Para incorporar la funcionalidad de CMFCColorBar a la aplicación:

Cree un botón de menú normal y asígnele un identificador, por ejemplo, ID_CHAR_COLOR.
En la clase de la ventana de marco, invalide el método CFrameWndEx::OnShowPopupMenu y reemplace el botón de menú normal por un objeto de la clase CMFCColorMenuButton (mediante una llamada a CMFCToolBar::ReplaceButton).
Establezca todos los estilos y habilite o deshabilite las características del objeto CMFCColorBar durante la creación de la clase CMFCColorMenuButton. El objeto CMFCColorMenuButton crea dinámicamente el objeto CMFCColorBar después de que el marco de trabajo llame al método CreatePopupMenu.

Cuando el usuario hace clic en un botón de control de barra de colores, el marco usa la macro ON_COMMAND para notificar al elemento primario del control de barra de colores. En la macro, el parámetro de identificador de comando es el valor que asignó al botón de control de barra de colores del paso 1 (ID_CHAR_COLOR, en este ejemplo). Para obtener más información, consulte las clases CMFCColorMenuButton, CMFCColorButton, CMFCColorPickerCtrl, CFrameWndEx y CMFCToolBar.

Ejemplo

En el ejemplo siguiente, se muestra cómo configurar una barra de colores mediante varios métodos de la clase CMFCColorBar. Los métodos establecen los márgenes horizontales y verticales, habilitan el otro botón, crean una ventana de control de barra de colores y establecen el color seleccionado actualmente. Este ejemplo forma parte del ejemplo de controles nuevos.

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 herencia

Requisitos

Encabezado: afxcolorbar.h

CMFCColorBar::AdjustLocations

Ajusta las posiciones de los botones de color en el control de barra de colores.

virtual void AdjustLocations();

Comentarios

El marco de trabajo llama a este método durante el procesamiento de mensajes WM_SIZE.

CMFCColorBar::AllowChangeTextLabels

Indica si la etiqueta de texto de los botones de color puede cambiar.

virtual BOOL AllowChangeTextLabels() const;

Valor devuelto

Siempre FALSE.

Comentarios

De manera predeterminada, este método siempre devuelve FALSE, lo que significa que no se pueden modificar las etiquetas de texto. Invalide este método para habilitar la modificación de las etiquetas de texto.

CMFCColorBar::AllowShowOnList

Indica si el objeto de control de barra de colores puede aparecer en una lista de barras de herramientas durante el proceso de personalización.

virtual BOOL AllowShowOnList() const;

Valor devuelto

Siempre TRUE.

Comentarios

De manera predeterminada, este método siempre devuelve TRUE, lo que significa que el marco de trabajo puede mostrar el control de barra de colores durante el proceso de personalización. Invalide este método para implementar un comportamiento diferente.

CMFCColorBar::CalcSize

Lo llama el marco como parte del proceso de cálculo de diseño.

virtual CSize CalcSize(BOOL bVertDock);

Parámetros

bVertDock
[in] TRUE para especificar que el control de barra de colores está acoplado verticalmente; FALSE para especificar que el control de barra de colores está acoplado horizontalmente.

Valor devuelto

Tamaño de la matriz de botones de color de un control de barra de colores.

CMFCColorBar::CMFCColorBar

Construye un objeto 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);

Parámetros

colors
[in] Matriz de colores que el marco de trabajo muestra en el control de barra de colores.

color
[in] Color seleccionado inicialmente.

lpszAutoColor
[in] Etiqueta de texto del botón de color automático (predeterminado) o NULL.

La etiqueta estándar para el botón automático es Automático.

lpszOtherColor
[in] Etiqueta de texto del otro botón, que muestra más opciones de color, o NULL.

La etiqueta estándar del otro botón es Más colores....

lpszDocColors
[in] Etiqueta de texto del botón de colores de documento. La paleta de colores de documento enumera todos los colores que usa actualmente el documento.

lstDocColors
[in] Lista de colores que usa actualmente el documento.

nColumns
[in] Número de columnas que tiene la matriz de colores.

nRowsDockHorz
[in] Número de filas que tiene la barra de colores cuando está acoplada horizontalmente.

nColDockVert
[in] Número de columnas que tiene la barra de colores cuando está acoplada verticalmente.

colorAutomatic
[in] Color predeterminado que aplica el marco de trabajo al hacer clic en el botón automático.

nCommandID
[in] Identificador de comando del control de barra de colores.

pParentBtn
[in] Puntero a un botón primario.

src
[in] Objeto CMFCColorBar existente que se va a copiar en el nuevo objeto CMFCColorBar.

uiCommandID
[in] Identificador del comando.

CMFCColorBar::ContextToSize

Calcula los márgenes verticales y horizontales necesarios para contener los botones del control de barra de colores y, a continuación, ajusta la ubicación de esos botones.

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

Parámetros

bSquareButtons
[in] TRUE para especificar que la forma de los botones de un control de barra de colores sea cuadrada; de lo contrario, FALSE. El valor predeterminado es TRUE.

bCenterButtons
[in] TRUE para especificar que el contenido de la cara de un botón de control de barra de colores está centrado; de lo contrario, FALSE. El valor predeterminado es TRUE.

Comentarios

CMFCColorBar::Create

Crea una ventana de control de barra de colores y la adjunta al objeto CMFCColorBar.

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

Parámetros

pParentWnd
[entrada] Un puntero a la ventana primaria.

dwStyle
[in] Combinación bit a bit (OR) de estilos de ventana.

Nid
[in] Identificador del comando.

pPalette
[in] Puntero a una paleta de colores. El valor predeterminado de es NULL.

nColumns
[in] Número de columnas del control de barra de colores. El valor predeterminado es 0.

nRowsDockHorz
[in] Número de filas del control de barra de colores cuando está acoplado horizontalmente. El valor predeterminado es 0.

nColDockVert
[in] Número de columnas del control de barra de colores cuando está acoplado verticalmente. El valor predeterminado es 0.

Valor devuelto

TRUE si este método se ejecuta correctamente; de lo contrario, FALSE.

Comentarios

Para construir un objeto CMFCColorBar, llame al constructor de la clase y, a continuación, a este método. El método Create crea el control de la ventana e inicializa una lista de colores.

CMFCColorBar::CreateControl

Crea una ventana de control de barra de colores, la adjunta al objeto CMFCColorBar y cambia el tamaño de la ventana del control para que contenga la paleta de colores especificada.

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

Parámetros

pParentWnd
[entrada] Un puntero a la ventana primaria. No puede ser NULL.

rect
[in] Rectángulo delimitador que especifica dónde dibujar el control de barra de colores.

Nid
[in] La id. del control.

nColumns
[in] Número ideal de columnas del control de barra de colores. Este método modifica ese número para ajustarse a la paleta de colores especificada. El valor predeterminado es -1, lo que significa que no se ha especificado este parámetro.

pPalette
[in] Puntero a una paleta de colores o NULL. Si este parámetro es NULL, este método calcula el tamaño del control de barra de colores como si se especificaran 20 colores. El valor predeterminado de es NULL.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

Comentarios

Este método usa los parámetros rect, nColumns y pPalette para calcular el número adecuado de filas y columnas en el control de barra de colores y, a continuación, llama al método CMFCColorBar::Create.

CMFCColorBar::CreatePalette

Inicializa una paleta con los colores de una matriz de colores especificada.

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

Parámetros

arColors
[in] Matriz de colores.

palette
[in] Paleta de colores.

Valor devuelto

TRUE si este método se ejecuta correctamente; de lo contrario, FALSE.

CMFCColorBar::EnableAutomaticButton

Muestra u oculta el botón automático.

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

Parámetros

lpszLabel
[in] Etiqueta de texto del botón de color automático (predeterminado) o NULL.

La etiqueta estándar para el botón automático es Automático.

colorAutomatic
[in] Color predeterminado que aplica el marco de trabajo al hacer clic en el botón automático.

bEnable
[in] TRUE para habilitar el botón automático; FALSE para deshabilitar el botón automático. El valor predeterminado es TRUE.

Comentarios

La etiqueta de texto del botón automático se elimina si el parámetro lpszLabel es NULL o el parámetro bEnable es FALSE.

CMFCColorBar::EnableOtherButton

Habilita o deshabilita la presentación de un cuadro de diálogo que permite al usuario seleccionar más colores.

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

Parámetros

lpszLabel
[in] Etiqueta de texto del otro botón, que muestra más opciones de color, o NULL.

La etiqueta estándar de este botón es Más colores....

bAltColorDlg
[in] TRUE para mostrar el cuadro de diálogo CMFCColorDialog; FALSE para mostrar el cuadro de diálogo CColorDialog estándar. El valor predeterminado es TRUE.

bEnable
[in] TRUE para habilitar el botón; FALSE para deshabilitarlo. El valor predeterminado es TRUE.

CMFCColorBar::GetColor

Recupera el color seleccionado actualmente.

COLORREF GetColor() const;

Valor devuelto

Color seleccionado actualmente.

CMFCColorBar::GetColorGridSize

Calcula el número de filas y columnas de la cuadrícula de un control de barra de colores.

CSize GetColorGridSize(BOOL bVertDock) const;

Parámetros

bVertDock
[in] TRUE para realizar el cálculo para un control de barra de colores acoplado verticalmente; de lo contrario, se realiza el cálculo para un control acoplado horizontalmente.

Valor devuelto

Objeto CSize cuyo componente cx contiene el número de columnas y cuyo componente cy contiene el número de filas.

CMFCColorBar::GetCommandID

Recupera el identificador de comando del control de barra de colores actual.

UINT GetCommandID() const;

Valor devuelto

Identificador de comando.

Comentarios

Cuando el usuario selecciona un nuevo color, el marco de trabajo envía el identificador de comando en un mensaje WM_COMMAND para notificar al elemento primario del objeto CMFCColorBar.

CMFCColorBar::GetExtraHeight

Calcula el alto adicional que requiere la barra de colores actual para mostrar varios elementos de la interfaz de usuario, como el botón Otros o los colores de documento.

int GetExtraHeight(int nNumColumns) const;

Parámetros

nNumColumns
[in] Si el control de barra de colores contiene colores de documento, número de columnas que se mostrarán en la cuadrícula de colores de documento. De lo contrario, este valor no se usa.

Valor devuelto

Alto adicional calculado que es necesario.

CMFCColorBar::GetHighlightedColor

Recupera el color que indica que un botón de color tiene el foco; es decir, el botón está activo.

COLORREF GetHighlightedColor() const;

Valor devuelto

Valor RGB.

Comentarios

CMFCColorBar::GetHorzMargin

Recupera el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.

int GetHorzMargin();

Valor devuelto

Margen horizontal.

CMFCColorBar::GetVertMargin

Recupera el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.

int GetVertMargin() const;

Valor devuelto

Margen vertical.

CMFCColorBar::InitColors

Inicializa una matriz de colores con los colores de una paleta especificada o con la paleta predeterminada del sistema.

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

Parámetros

pPalette
[in] Puntero a un objeto de paleta o NULL. Si este parámetro es NULL, este método usa la paleta predeterminada del sistema operativo.

arColors
[in] Matriz de colores.

Valor devuelto

Número de elementos de la matriz de colores.

CMFCColorBar::IsTearOff

Indica si la barra de color actual es acoplable.

BOOL IsTearOff() const;

Valor devuelto

TRUE si el control de barra de colores actual es acoplable; de lo contrario, FALSE.

Comentarios

Si el control de barra de colores es acoplable, se puede desacoplar de una barra de control y acoplar en otra ubicación.

CMFCColorBar::OnKey

Lo llama el marco de trabajo cuando un usuario pulsa un botón de teclado.

virtual BOOL OnKey(UINT nChar);

Parámetros

nChar
[in] Código de tecla virtual de la tecla que ha pulsado el usuario.

Valor devuelto

TRUE si este método procesa la tecla especificada; de lo contrario, FALSE.

CMFCColorBar::OnSendCommand

Lo llama el marco de trabajo para cerrar una jerarquía de controles emergentes.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parámetros

pButton
[in] Puntero a un control que reside en una barra de herramientas.

Valor devuelto

TRUE si este método se ejecuta correctamente; de lo contrario, FALSE.

CMFCColorBar::OnUpdateCmdUI

Lo llama el marco de trabajo para habilitar o deshabilitar un elemento de interfaz de usuario de un control de barra de colores antes de que se muestre el elemento.

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

Parámetros

pTarget
[in] Puntero a una ventana que contiene un elemento de interfaz de usuario que se va a actualizar.

bDisableIfNoHndler
[in] TRUE para deshabilitar el elemento de interfaz de usuario si no se define ningún controlador en un mapa de mensajes; de lo contrario, FALSE.

Comentarios

Cuando un usuario de la aplicación hace clic en un elemento de la interfaz de usuario, el elemento debe saber si se debe mostrar como habilitado o deshabilitado. El destino del mensaje de comando proporciona esta información mediante la implementación de un controlador de comandos ON_UPDATE_COMMAND_UI. Use este método para ayudar a procesar el comando. Para más información, consulte la clase CCmdUI.

CMFCColorBar::OpenColorDialog

Abre un cuadro de diálogo de color.

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

Parámetros

colorDefault
[in] Color seleccionado de manera predeterminada cuando se abre el cuadro de diálogo de colores.

colorRes
[out] Color seleccionado por un usuario.

Valor devuelto

TRUE si el usuario seleccionó un color; FALSE si el usuario canceló el cuadro de diálogo de colores.

Comentarios

CMFCColorBar::Rebuild

Vuelve a dibujar completamente el control de barra de colores.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Establece la paleta lógica del contexto de dispositivo especificado en la paleta del botón primario del control de barra de colores actual.

CPalette* SelectPalette(CDC* pDC);

Parámetros

pDC
[in] Puntero al contexto del dispositivo del botón primario del control de barra de colores actual.

Valor devuelto

Puntero a la paleta que se reemplaza por la paleta del botón primario del control de barra de colores actual.

CMFCColorBar::SetColor

Establece el color seleccionado actualmente.

void SetColor(COLORREF color);

Parámetros

color
[in] Valor de color RGB.

CMFCColorBar::SetColorName

Establece un nuevo nombre para el color especificado.

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

Parámetros

color
[in] Valor RGB de un color.

strName
[in] Nuevo nombre del color especificado.

Comentarios

Este método cambia el nombre del color especificado en todos los objetos CMFCColorBar de la aplicación.

CMFCColorBar::SetCommandID

Establece un nuevo identificador de comando para un control de barra de colores.

void SetCommandID(UINT nCommandID);

Parámetros

nCommandID
[in] Identificador de comando.

Comentarios

Llame a este método para modificar el identificador de comando de un control de barra de colores y para notificar a la ventana primaria del control que el identificador ha cambiado.

CMFCColorBar::SetDocumentColors

Establece la lista de colores que se usan en el documento actual.

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

Parámetros

lpszCaption
[in] Título que se muestra cuando el control de barra de colores no está acoplado.

lstDocColors
[in] Lista de colores que reemplaza los colores de documento actuales.

bShowWhenDocked
[in] TRUE para mostrar los colores de documento cuando el control de barra de colores está acoplado; de lo contrario, FALSE. El valor predeterminado es FALSE.

Comentarios

Los colores de documento son los colores que se usan actualmente en un documento. El marco de trabajo mantiene automáticamente una lista de colores de documento, pero puede usar este método para modificar la lista.

CMFCColorBar::SetHorzMargin

Establece el margen horizontal, que es el espacio entre la celda de color izquierda o derecha y el límite del área cliente.

void SetHorzMargin(int nHorzMargin);

Parámetros

nHorzMargin
[in] Margen horizontal, en píxeles.

Comentarios

De manera predeterminada, el constructor CMFCColorBar::CMFCColorBar establece el margen horizontal en 4 píxeles.

CMFCColorBar::SetPropList

Establece el miembro de datos protegido m_pWndPropList en el puntero especificado a un control de cuadrícula de propiedades.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parámetros

pWndList
[in] Puntero a un objeto de control de cuadrícula de propiedades.

CMFCColorBar::SetVertMargin

Establece el margen vertical, que es el espacio entre la celda de color superior o inferior y el límite del área cliente.

void SetVertMargin(int nVertMargin);

Parámetros

nVertMargin
[in] Margen vertical, en píxeles.

Comentarios

De manera predeterminada, el constructor CMFCColorBar::CMFCColorBar establece el margen vertical en 4 píxeles.

CMFCColorBar::ShowCommandMessageString

Solicita a la ventana de marco que posee el control de barra de colores que actualice la línea de mensajes en la barra de estado.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parámetros

uiCmdId
[in] Identificador de comando. (Este parámetro se ignora).

Comentarios

Este método envía el mensaje WM_SETMESSAGESTRING al propietario del control de barra de colores.

Consulte también

Gráfico de jerarquías
Clases

Compartir a través de

Clase CMFCColorBar

Sintaxis

Miembros

Constructores protegidos

Métodos públicos

Métodos protegidos

Miembros de datos protegidos

Comentarios

Ejemplo

Jerarquía de herencia

Requisitos

CMFCColorBar::AdjustLocations

Comentarios

CMFCColorBar::AllowChangeTextLabels

Valor devuelto

Comentarios

CMFCColorBar::AllowShowOnList

Valor devuelto

Comentarios

CMFCColorBar::CalcSize

Parámetros

Valor devuelto

CMFCColorBar::CMFCColorBar

Parámetros

CMFCColorBar::ContextToSize

Parámetros

Comentarios

CMFCColorBar::Create

Parámetros

Valor devuelto

Comentarios

CMFCColorBar::CreateControl

Parámetros

Valor devuelto

Comentarios

CMFCColorBar::CreatePalette

Parámetros

Valor devuelto

CMFCColorBar::EnableAutomaticButton

Parámetros

Comentarios

CMFCColorBar::EnableOtherButton

Parámetros

CMFCColorBar::GetColor

Valor devuelto

CMFCColorBar::GetColorGridSize

Parámetros

Valor devuelto

CMFCColorBar::GetCommandID

Valor devuelto

Comentarios

CMFCColorBar::GetExtraHeight

Parámetros

Valor devuelto

CMFCColorBar::GetHighlightedColor

Valor devuelto

Comentarios

CMFCColorBar::GetHorzMargin

Valor devuelto

CMFCColorBar::GetVertMargin

Valor devuelto

CMFCColorBar::InitColors

Parámetros

Valor devuelto

CMFCColorBar::IsTearOff

Valor devuelto

Comentarios

CMFCColorBar::OnKey

Parámetros

Valor devuelto

CMFCColorBar::OnSendCommand

Parámetros

Valor devuelto

CMFCColorBar::OnUpdateCmdUI

Parámetros

Comentarios

CMFCColorBar::OpenColorDialog

Parámetros

Valor devuelto