Clase de CMFCColorBar

Artículo
04/10/2013

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

class CMFCColorBar : public CMFCPopupMenuBar

Members

Constructores protegidos

Name	Descripción
CMFCColorBar::CMFCColorBar	Crea un objeto CMFCColorBar.

Métodos públicos

Name	Descripción
CMFCColorBar::ContextToSize	Calcula los márgenes verticales y horizontales necesarios para contener los botones del control de barra de color y ajustar la ubicación de los botones.
CMFCColorBar::CreateControl	Crea una ventana de control de la barra de color, la asocia el objeto de CMFCColorBar , y cambia el tamaño del control para contener la paleta especificada de colores.
CMFCColorBar::Create	Crea una ventana de control de la barra de color y la agrega al objeto de 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 del control actual de la barra de color.
CMFCColorBar::GetHighlightedColor	Recupera el color que significa 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 de la izquierda o la derecha y el límite del área cliente.
CMFCColorBar::GetVertMargin	Recupera el margen vertical, que es el espacio entre la celda de color de la parte superior o inferior y el límite del área cliente.
CMFCColorBar::IsTearOff	Indica si la barra de color actual es acoplables.
CMFCColorBar::SetColor	Establece el color que está actualmente seleccionado.
CMFCColorBar::SetColorName	Establece un nuevo nombre para el color especificado.
CMFCColorBar::SetCommandID	Establece un nuevo identificador de comando para un control de barra de color.
CMFCColorBar::SetDocumentColors	Establece la lista de colores que se utilizan en el documento actual.
CMFCColorBar::SetHorzMargin	Establece el margen horizontal, que es el espacio entre la celda de color de la izquierda o la derecha y el límite del área cliente.
CMFCColorBar::SetVertMargin	Establece el margen vertical, que es el espacio entre la parte superior o inferior la celda en color y el límite de área cliente.

Métodos protegidos

Name	Descripción
CMFCColorBar::AdjustLocations	Ajusta las posiciones de color respecto al control de barra de color.
CMFCColorBar::AllowChangeTextLabels	Indica si la etiqueta de texto de botones de color puede cambiar.
CMFCColorBar::AllowShowOnList	Indica si el objeto de control de la barra de color puede aparecer en una lista de barras de herramientas durante el proceso de personalización.
CMFCColorBar::CalcSize	Llamado por el marco como parte del proceso de cálculo de diseño.
CMFCColorBar::CreatePalette	Initalizes una paleta con los colores en una matriz de colores.
CMFCColorBar::GetColorGridSize	Calcula el número de filas y columnas en la cuadrícula de un control de barra de color.
CMFCColorBar::GetExtraHeight	Calcula el alto adicional que la barra de color actual requiere para mostrar elementos diferentes de la interfaz de usuario como el botón de Otros , documentan colores, y así sucesivamente.
CMFCColorBar::InitColors	Inicializa una matriz de colores con los colores de una paleta especificada o la paleta predeterminada del sistema.
CMFCColorBar::OnKey	Llamado por el marco cuando un usuario presiona un botón de teclado.
CMFCColorBar::OnSendCommand	Llamado por el marco para cerrar una jerarquía de controles móviles.
CMFCColorBar::OnUpdateCmdUI	Llamado por el marco para habilitar o deshabilitar un elemento de la interfaz de usuario de un control de barra de color antes de elemento se muestra.
CMFCColorBar::OpenColorDialog	Abre un cuadro de diálogo color.
CMFCColorBar::Rebuild	Redibuja completamente el control de barra de color.
CMFCColorBar::SelectPalette	Establece la paleta lógica de contexto especificado de dispositivo con la paleta del botón primario del control actual de la barra de color.
CMFCColorBar::SetPropList	Establezca el miembro de datos protegido m_pWndPropList el puntero especificado a un control de cuadrícula de propiedades.
CMFCColorBar::ShowCommandMessageString	Solicita la ventana de marco propietaria del control de barra de color para actualizar la línea de mensajes en la barra de estado.

Miembros de datos protegidos

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

Comentarios

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

La clase de CMFCColorBar proporciona la funcionalidad siguiente:

Incluye automáticamente a la lista de colores del documento.
Guarda y restaura su estado, así como el estado del documento.
Administra el botón “automático”.
Utiliza el control de Clase de CMFCColorPickerCtrl para seleccionar un color personalizado.
Admite “rasgan” el estado (si se crea utilizando Clase de CMFCColorMenuButton).

Para incorporar la funcionalidad de CMFCColorBar en su aplicación:

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

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

Ejemplo

El ejemplo siguiente muestra cómo configurar una barra de color mediante varios métodos en la clase de CMFCColorBar .Los métodos establecen los márgenes horizontales y verticales, permiten el otro botón, crea una ventana de control de la barra de color, y establece el color seleccionado actualmente.Este ejemplo forma parte de nuevo ejemplo de Controles.

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