Clase CMFCRibbonPanel

Artículo
06/16/2023

Implementa un panel que contiene un conjunto de elementos de cinta. Cuando se dibuja el panel, muestra tantos elementos como es posible, dado el tamaño del panel.

Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Sintaxis

class CMFCRibbonPanel : public CObject

Miembros

Constructores protegidos

Nombre	Descripción
CMFCRibbonPanel::CMFCRibbonPanel	Construye e inicializa un objeto `CMFCRibbonPanel`.

Métodos públicos

Nombre	Descripción
CMFCRibbonPanel::Add	Agrega un elemento de cinta de opciones al panel.
CMFCRibbonPanel::AddSeparator	Agrega un separador a la barra de opciones de estado de la barra de opciones.
CMFCRibbonPanel::AddToolBar	Agrega una barra de opciones de herramientas al panel de la barra de opciones.
CMFCRibbonPanel::FindByData
CMFCRibbonPanel::FindByID	Devuelve un elemento identificado por un identificador de comando especificado.
CMFCRibbonPanel::GetCaptionHeight
CMFCRibbonPanel::GetCount	Devuelve el número de elementos del panel de la barra de opciones.
CMFCRibbonPanel::GetData	Devuelve los datos definidos por el usuario asociados al panel.
CMFCRibbonPanel::GetDefaultButton
CMFCRibbonPanel::GetDroppedDown
CMFCRibbonPanel::GetElement	Devuelve el elemento de cinta ubicado en un índice especificado.
CMFCRibbonPanel::GetElements	Recupera todos los elementos contenidos en el panel de la cinta de opciones.
CMFCRibbonPanel::GetElementsByID
CMFCRibbonPanel::GetFocused	Devuelve un elemento que tiene el foco.
CMFCRibbonPanel::GetGalleryRect	Devuelve un rectángulo delimitador del elemento Gallery.
CMFCRibbonPanel::GetHighlighted
CMFCRibbonPanel::GetIndex
CMFCRibbonPanel::GetItemIDsList
CMFCRibbonPanel::GetName
CMFCRibbonPanel::GetParentButton
CMFCRibbonPanel::GetParentCategory	Devuelve la categoría primaria del panel de la barra de opciones.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanel::GetPreferedMenuLocation
CMFCRibbonPanel::GetPressed
CMFCRibbonPanel::GetRect
CMFCRibbonPanel::GetVisibleElements	Obtiene una matriz de elementos visibles.
CMFCRibbonPanel::HasElement
CMFCRibbonPanel::HitTest
CMFCRibbonPanel::HitTestEx
CMFCRibbonPanel::Insert	Inserta un elemento de barra de opciones en la posición especificada.
CMFCRibbonPanel::InsertSeparator	Inserta un separador en la posición especificada.
CMFCRibbonPanel::IsCenterColumnVert	Especifica si todos los elementos del panel deben centrarse (alineados) verticalmente, por columna.
CMFCRibbonPanel::IsCollapsed
CMFCRibbonPanel::IsHighlighted
CMFCRibbonPanel::IsJustifyColumns	Especifica si todas las columnas del panel tienen el mismo ancho.
CMFCRibbonPanel::IsMainPanel
CMFCRibbonPanel::IsMenuMode
CMFCRibbonPanel::MakeGalleryItemVisible	Desplaza la galería para que el elemento barra de opciones especificado esté visible.
CMFCRibbonPanel::OnKey
CMFCRibbonPanel::RecalcWidths
CMFCRibbonPanel::Remove	Quita y, opcionalmente, elimina un elemento ubicado en el índice especificado.
CMFCRibbonPanel::RemoveAll	Quita todos los elementos del panel de la barra de opciones.
CMFCRibbonPanel::Replace	Reemplaza un elemento por otro en función de sus respectivos valores de índice.
CMFCRibbonPanel::ReplaceByID	Reemplaza un elemento por otro en función de un identificador de comando especificado.
CMFCRibbonPanel::SetCenterColumnVert	Ordena al panel que alinee los elementos verticalmente, por columna.
CMFCRibbonPanel::SetData	Asocia datos definidos por el usuario con el panel de la cinta de opciones.
CMFCRibbonPanel::SetElementMenu	Asigna un menú emergente al elemento que tiene el identificador de comando especificado.
CMFCRibbonPanel::SetElementRTC	Agrega un elemento de barra de opciones especificado por la información de la clase en tiempo de ejecución proporcionada al panel de la cinta de opciones.
CMFCRibbonPanel::SetElementRTCByID	Agrega un elemento de barra de opciones especificado por la información de la clase en tiempo de ejecución proporcionada al panel de la cinta de opciones.
CMFCRibbonPanel::SetFocused	Establece el foco en el elemento de la barra de opciones especificado.
CMFCRibbonPanel::SetJustifyColumns	Habilita o deshabilita la justificación de columna.
CMFCRibbonPanel::SetKeys	Establece el método abreviado de teclado que muestra el panel de la barra de opciones.
CMFCRibbonPanel::ShowPopup

Comentarios

Los paneles de cinta de opciones son agrupaciones lógicas de tareas relacionadas que se crean dentro de las categorías de la barra de opciones. A medida que cambia el tamaño de la barra de opciones, el diseño del panel se ajusta automáticamente para mostrar tantos elementos como sea posible.

Puedes obtener un panel de barra de opciones que se encuentra en una categoría de barra de opciones llamando al método CMFCRibbonCategory::GetPanel.

Ejemplo

En el ejemplo siguiente se muestra cómo configurar un objeto CMFCRibbonPanel mediante varios métodos de la clase CMFCRibbonPanel. En el ejemplo se muestra cómo establecer el método abreviado de teclado que muestra el panel de la cinta de opciones, alinear los elementos del panel verticalmente por columna y habilitar la justificación de columna. Este fragmento de código forma parte del ejemplo de demostración de MS Office 2007.

// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();

Jerarquía de herencia

CObject

CMFCRibbonPanel

Requisitos

Encabezado: afxRibbonPanel.h

CMFCRibbonPanel::Add

Anexa el elemento de cinta especificado a la matriz de elementos de cinta de opciones contenidos en el panel de la cinta de opciones.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parámetros

pElem
[in, out] Puntero a un elemento de la barra de opciones.

Comentarios

CMFCRibbonPanel::AddSeparator

Agrega un separador a la barra de opciones de estado de la barra de opciones.

virtual void AddSeparator();

Comentarios

Llama a este método para agregar un separador al panel de la barra de opciones. El separador se agregará junto al elemento de barra de opciones que se agregó la llamada anterior a CMFCRibbonPanel::Add. Para insertar un separador en una posición determinada, llama a CMFCRibbonPanel::InsertSeparator.

CMFCRibbonPanel::AddToolBar

Agrega una barra de opciones de herramientas al panel de la barra de opciones.

CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);

Parámetros

uiToolbarResID
[in] Especifica el identificador de recurso de la barra de opciones de herramientas a añadir.

uiColdResID
[in] Especifica el ID de recurso de las imágenes frías de la barra de opciones de herramientas.

uiHotResID
[in] Especifica el identificador de recurso de la barra de opciones de herramientas.

uiDisabledResID
[in] Especifica el ID del recurso de las imágenes desactivadas de la barra de opciones de herramientas.

Valor devuelto

Llame a este método para añadir una barra de opciones de herramientas al panel de la barra de opciones. La barra de opciones de herramientas se agregará junto al elemento de barra de opciones añadida la llamada anterior a CMFCRibbonPanel::Add.

Comentarios

Para obtener más información sobre las barra de opcioness de herramientas, las imágenes activas, las imágenes inactivas y las imágenes deshabilitadas, consulta Clase CMFCToolBar.

CMFCRibbonPanel::CMFCRibbonPanel

Construye e inicializa un objeto CMFCRibbonPanel.

CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);

CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);

Parámetros

lpszName
[in] El nombre del panel de la cinta de opciones.

hIcon
[in] Controla el icono del botón predeterminado para el panel de la barra de opciones.

pPaletteButton
[in] Puntero a una galería de cintas para el panel de la cinta de opciones.

CMFCRibbonPanel::FindByData

Recupera el elemento de la barra de opciones que está asociada a los datos especificados.

CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;

Parámetros

dwData
[in] Los datos asociados a un elemento de la barra de opciones.

Valor devuelto

Puntero a un elemento de la cinta de opciones si el método se realizó correctamente; en caso contrario, NULL.

Comentarios

CMFCRibbonPanel::FindByID

Recupera el elemento de la cinta de opciones identificado por el identificador de comando especificado.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;

Parámetros

uiCmdID
[in] El identificador de comando de un elemento de la cinta.

Valor devuelto

Elemento de barra de opciones identificado por el identificador de comando especificado; de lo contrario, NULL si no se identifica ningún elemento de la cinta con el identificador de comando especificado.

CMFCRibbonPanel::GetCaptionHeight

Recupera la atura de un título para el panel de la barra de opciones.

int GetCaptionHeight() const;

Valor devuelto

Altura en píxeles, de un título para el panel de la barra de opciones.

Comentarios

CMFCRibbonPanel::GetCount

Recupera el número de elementos de la barra de opciones contenidos en el panel de la barra de opciones.

int GetCount() const;

Valor devuelto

Número de elementos de la barra de opciones contenidos en el panel de la barra de opciones.

CMFCRibbonPanel::GetData

Devuelve los datos definidos por el usuario asociados al panel.

DWORD_PTR GetData() const;

Valor devuelto

Los datos definidos por el usuario asociados al panel.

CMFCRibbonPanel::GetDefaultButton

Recupera el botón predeterminado para el panel de la barra de opciones.

CMFCRibbonButton& GetDefaultButton();

Valor devuelto

Botón predeterminado para el panel de la barra de opciones.

Comentarios

El botón predeterminado se muestra cuando un panel de cinta de opciones no tiene espacio suficiente para mostrar sus elementos de la barra de opciones.

CMFCRibbonPanel::GetDroppedDown

Recupera un puntero a un elemento de la barra de opciones si se coloca su menú emergente.

CMFCRibbonBaseElement* GetDroppedDown() const;

Valor devuelto

Puntero al elemento de la cinta de opciones que tiene su menú emergente desplegable; de lo contrario, NULL si no hay ningún elemento de la barra de opciones con su menú emergente desplegable.

Comentarios

Solo se prueban los elementos de la barra de opciones contenidos en el panel de la barra de opciones.

CMFCRibbonPanel::GetElement

Devuelve el elemento de cinta ubicado en un índice especificado.

CMFCRibbonBaseElement* GetElement(int nIndex) const;

Parámetros

nIndex
[in] Especifica el índice de base cero del elemento que se va a recuperar.

Valor devuelto

Un puntero válido al elemento de la cinta base ubicado en la posición nIndex del panel de la cinta de opciones o NULL si no hay ningún elemento en el índice especificado.

CMFCRibbonPanel::GetElements

Recupera todos los elementos contenidos en el panel de la barra de opciones.

void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parámetros

arElements
[out] Una matriz que se rellenará con todos los elementos de la barra de opciones contenidos en el panel de la barra de opciones.

Comentarios

CMFCRibbonPanel::GetElementsByID

Añade los elementos de la barra de opciones que tienen el ID de comando especificado a la matriz especificada.

void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parámetros

uiCmdID
[in] Identificador de comando de un elemento de la cinta.

arElements
[in] Matriz de elementos de la barra de opciones.

Comentarios

Solo se prueban los elementos de la barra de opciones contenidos en el panel de la barra de opciones.

CMFCRibbonPanel::GetHighlighted

Recupera el elemento de la barra de opciones resaltado en el panel de la cinta de opciones.

CMFCRibbonBaseElement* GetHighlighted() const;

Valor devuelto

Puntero al elemento de la barra de opciones resaltado en el panel de la cinta de opciones.

Comentarios

CMFCRibbonPanel::GetIndex

Recupera el índice de base cero del elemento de cinta especificado de la matriz de elementos de la cinta de opciones contenidos en el panel de la cinta de opciones.

virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;

Parámetros

pElem
[in] Puntero a un elemento de la cinta.

Valor devuelto

Índice de base cero del elemento de la barra de opciones especificado si el método tuvo éxito; en caso contrario, -1.

Comentarios

CMFCRibbonPanel::GetItemIDsList

Recupera los identificadores de comando de todos los elementos de la barra de opciones del panel de la barra de opciones.

void GetItemIDsList(CList<UINT, UINT>& lstItems) const;

Parámetros

lstItems
[out] La lista de identificadores de comando para los elementos de barra de opciones que se encuentran en el panel de la barra de opciones.

Comentarios

CMFCRibbonPanel::GetName

Recupera el nombre del panel de la barra de opciones.

LPCTSTR GetName() const;

Valor devuelto

El nombre del panel de la cinta de opciones.

Comentarios

CMFCRibbonPanel::GetParentButton

CMFCRibbonBaseElement* GetParentButton() const;

Valor devuelto

Comentarios

CMFCRibbonPanel::GetParentCategory

Devuelve la categoría primaria del panel de la barra de opciones.

CMFCRibbonCategory* GetParentCategory() const;

Valor devuelto

Puntero a la categoría de la barra de opciones que contiene este panel de cinta de opciones.

CMFCRibbonPanel::GetParentMenuBar

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Valor devuelto

Comentarios

CMFCRibbonPanel::GetPreferedMenuLocation

Recupera el rectángulo de pantalla preferido para el menú emergente del panel de la barra de opciones.

virtual BOOL GetPreferedMenuLocation(CRect& rect);

Parámetros

rect
[in] Este parámetro no se utiliza.

Valor devuelto

Siempre devuelve FALSE.

Comentarios

Este método siempre devuelve FALSE. Invalida este método para recuperar el rectángulo de pantalla preferido para el menú emergente del panel de la barra de opciones.

CMFCRibbonPanel::GetPressed

Recupera un puntero a un elemento de la cinta de opciones en el panel de la barra de opciones si el usuario lo pulsa actualmente.

CMFCRibbonBaseElement* GetPressed() const;

Valor devuelto

Un puntero al elemento de la barra si el usuario lo presiona; en caso contrario, se devuelve el valor NULL.

Comentarios

CMFCRibbonPanel::GetRect

Recupera el rectángulo de visualización del panel de la barra de opciones.

const CRect& GetRect() const;

Valor devuelto

Rectángulo de visualización de la categoría de la barra de opciones.

Comentarios

CMFCRibbonPanel::HasElement

Indica si el panel de la barra de opciones contiene el elemento de cinta de opciones especificado.

BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;

Parámetros

pElem
[in] Puntero a un elemento de la cinta.

Valor devuelto

TRUE si el panel de la barra de opciones contiene el elemento de barra de opciones especificado; en caso contrario, FALSE.

Comentarios

CMFCRibbonPanel::Highlight

Establece el color de resaltado para el panel de cinta seleccionado y para el elemento de barra especificado por el punto.

virtual void Highlight(
BOOL bHighlight,
CPoint point);

Parámetros

bHighlight
[in] TRUE para resaltar el panel de la cinta de opciones; FALSE para desactivar el panel de la barra de opciones.

point
[in] Coordenadas X e Y del puntero, relativas a la esquina superior izquierda de la ventana.

Comentarios

CMFCRibbonPanel::HitTest

Recupera un puntero a un elemento de la barra de opciones si el punto especificado se encuentra en él.

virtual CMFCRibbonBaseElement* HitTest(
CPoint point,
BOOL bCheckPanelCaption = FALSE);

Parámetros

point
[in] Coordenadas X e Y del puntero, relativas a la esquina superior izquierda de la ventana.

bCheckPanelCaption
[in] TRUE para probar el título del panel de la barra de opciones; en caso contrario, FALSE.

Valor devuelto

Puntero a un elemento de la barra de opciones si el punto especificado se encuentra en él; de lo contrario, NULL.

Comentarios

Solo se prueban los elementos de la barra de opciones contenidos en el panel de la barra de opciones.

CMFCRibbonPanel::HitTestEx

Recupera el índice de base cero de un elemento de la barra de opciones si el punto especificado se encuentra en él.

virtual int HitTestEx(CPoint point) const;

Parámetros

point
[in] Coordenadas X e Y del puntero, relativas a la esquina superior izquierda de la ventana.

Valor devuelto

Índice de base cero del elemento de cinta de opciones que tiene el punto especificado ubicado en él; en caso contrario, -1.

Comentarios

Solo se prueban los elementos de la barra de opciones contenidos en el panel de la barra de opciones.

CMFCRibbonPanel::Insert

Inserta el elemento de cinta de opciones especificado en la posición especificada en la matriz de elementos de cinta de opciones contenidos en el panel de la cinta de opciones.

virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);

Parámetros

pElem
[in, out] Puntero a un elemento de la barra de opciones.

nIndex
[in] Valor de base cero, que va desde -1 hasta el número de elementos de la cinta de opciones contenidos en la matriz.

Valor devuelto

TRUE si el elemento de la cinta de opciones se insertó correctamente; en caso contrario, FALSE.

Comentarios

Si el valor de nIndex es -1 o si nIndex es igual al número de elementos de la barra de opciones de la matriz, el elemento de barra especificado se agrega al final de la matriz. Si el valor de nIndex está fuera del intervalo, se producirá un error en el método.

CMFCRibbonPanel::InsertSeparator

Inserta un separador en la posición especificada.

virtual BOOL InsertSeparator(int nIndex);

Parámetros

nIndex
[in] Especifica el índice de base cero donde se inserta el separador.

Valor devuelto

TRUE si el separador se ha insertado correctamente; de lo contrario, FALSE.

Comentarios

Llama a este método para insertar un separador en la posición especificada por nIndex. Para insertar un separador junto al elemento de cinta agregado más recientemente, llama a CMFCRibbonPanel::AddSeparator.

CMFCRibbonPanel::IsCenterColumnVert

Indica si las posiciones verticales de los elementos de la cinta se centran dentro de su rectángulo para mostrar.

BOOL IsCenterColumnVert() const;

Valor devuelto

TRUE si las posiciones verticales de los elementos de la cinta se centran dentro de su rectángulo de presentación; en caso contrario, FALSE.

CMFCRibbonPanel::IsCollapsed

Indica si el tamaño de presentación del panel de la barra de opciones se minimiza en la dirección horizontal.

BOOL IsCollapsed() const;

Valor devuelto

TRUE si el tamaño de presentación del panel de la barra de opciones se minimiza en la dirección horizontal; en caso contrario, FALSE.

Comentarios

Cuando se contrae un panel de barra de opciones, solo muestra su botón predeterminado, su nombre y una flecha desplegable.

CMFCRibbonPanel::IsHighlighted

Indica si la presentación del panel de la barra está resaltada.

BOOL IsHighlighted() const;

Valor devuelto

TRUE si la presentación del panel de la barra está resaltada; en caso contrario, FALSE.

Comentarios

La presentación de un panel de barra de opciones se resalta cuando el puntero está sobre él.

CMFCRibbonPanel::IsJustifyColumns

Indica si las dimensiones de visualización de los elementos de la barra de opciones que se encuentran en la misma columna del panel de la barra de opciones se establecen en el mismo ancho.

BOOL IsJustifyColumns() const;

Valor devuelto

TRUE si las dimensiones para mostrar de los elementos de la barra de opciones que se encuentran en la misma columna del panel de la barra de opciones se establecen en el mismo ancho; en caso contrario, FALSE.

CMFCRibbonPanel::IsMainPanel

Indica si el panel de la barra de opciones es el panel principal de la barra de opciones.

virtual BOOL IsMainPanel() const;

Valor devuelto

Siempre devuelve FALSE.

Comentarios

Este método siempre devuelve FALSE. Invalida este método para indicar si el panel de la barra de opciones es el panel principal de la barra de opciones.

El panel principal de la barra de opciones se muestra cuando el usuario selecciona el botón de la aplicación.

CMFCRibbonPanel::IsMenuMode

BOOL IsMenuMode() const;

Valor devuelto

Comentarios

CMFCRibbonPanel::OnKey

virtual BOOL OnKey(UINT nChar);

Parámetros

[in] nChar

Valor devuelto

Comentarios

CMFCRibbonPanel::RecalcWidths

Actualiza el ancho de cada configuración de diseño de pantalla para el panel de la barra de opciones.

virtual void RecalcWidths(
CDC* pDC,
int nHeight);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo para los paneles de la barra de opciones.

nHeight
[in] Altura del panel de la barra de opciones.

Comentarios

Un panel de la barra de opciones cambia su configuración de diseño a medida que cambia el ancho disponible.

CMFCRibbonPanel::Remove

Quita y, opcionalmente, elimina un elemento ubicado en el índice especificado.

BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);

Parámetros

nIndex
[in] Especifica el índice de base cero del elemento que se quita del panel de la barra de opciones.

bDelete
[in] TRUE para eliminar el elemento que se va a quitar; de lo contrario, FALSE.

Valor devuelto

TRUE si el elemento se ha quitado y eliminado (si bDelete es TRUE); FALSE si el elemento no se quitó o si no hay ningún elemento de barra de opciones ubicado en nIndex.

Comentarios

Llama a este método para quitar un elemento del panel de la barra de opciones.

CMFCRibbonPanel::RemoveAll

Elimina todos los elementos de la barra de opciones del panel de la barra de opciones.

void RemoveAll();

Comentarios

Todos los elementos de la barra se eliminan del panel de la barra de opciones y se destruyen.

CMFCRibbonPanel::Replace

Reemplaza un elemento por otro en función de sus valores de índice.

BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);

Parámetros

nIndex
[in] Especifica el índice de base cero del elemento que se va a recuperar.

pElem
[in, out] Puntero válido al elemento que reemplaza al elemento original.

Valor devuelto

TRUE si el elemento original de la barra de opciones se ha reemplazado correctamente por el nuevo elemento de la barra de opciones; FALSE si el elemento de la barra de opciones no se ha reemplazado o si no hay ningún elemento en el índice especificado.

Comentarios

Para reemplazar un elemento de barra por identificador de comando, llama a CMFCRibbonPanel::ReplaceByID.

CMFCRibbonPanel::ReplaceByID

Reemplaza un elemento por otro en función de un identificador de comando especificado.

BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);

Parámetros

uiCmdID
[in] Especifica el identificador de comando del elemento que se va a reemplazar.

pElem
[in, out] Un puntero válido al elemento que reemplaza al elemento original.

Valor devuelto

TRUE si el elemento de la barra de opciones original ha sido sustituido con éxito por el nuevo elemento de la cinta; FALSE si el elemento de la cinta no ha sido sustituido o si no existe ningún elemento con el ID de comando especificado.

Comentarios

raPara reemplazar un elemento de cinta basado en la posición, llame a CMFCRibbonPanel::Replace.

CMFCRibbonPanel::SetCenterColumnVert

Habilita o deshabilita el centro de las posiciones verticales de los elementos de la barra dentro de su rectángulo para mostrar.

void SetCenterColumnVert(BOOL bSet = TRUE);

Parámetros

bSet
[in] TRUE para centrar las posiciones verticales de los elementos de barra dentro de su rectángulo de presentación; FALSE para deshabilitar esta característica.

Comentarios

CMFCRibbonPanel::SetData

Asocia datos definidos por el usuario con el panel de la cinta de opciones.

void SetData(DWORD_PTR dwData);

Parámetros

dwData
Especifica el código de datos a establecer definido por el usuario.

Comentarios

Llama a este método para asociar datos definidos por el usuario con el panel de la cinta de opciones.

CMFCRibbonPanel::SetElementMenu

Asigna un menú emergente al elemento que tiene el identificador de comando especificado.

BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

Parámetros

uiCmdID
[in] Especifica el identificador de comando del elemento de cinta donde se agrega el menú.

hMenu
[in] Especifica el identificador del menú de Windows que se va a agregar al panel de la barra de opciones.

bIsDefautCommand
[in] TRUE para especificar que se debe ejecutar el comando asociado al elemento de barra de opciones si se hace clic en el elemento de la barra de opciones. En este caso, el menú solo se abre cuando el usuario hace clic en la flecha situada junto al elemento de la barra de opciones. FALSE para especificar que el comando asociado al elemento de barra de opciones no se debe ejecutar si se hace clic en el elemento de la barra de opciones. En este caso, el menú emergente aparece independientemente de dónde haga clic el usuario en el elemento.

bRightAlign
[in] TRUE para especificar que el menú emergente está alineado a la derecha; de lo contrario, FALSE.

uiMenuResID
[in] Especifica el identificador de recurso del menú que se va a agregar al panel de la barra de opciones.

Valor devuelto

TRUE si el menú se ha asignado al elemento de la barra de opciones; de lo contrario, FALSE.

Comentarios

Llama a este método para asignar un menú emergente al elemento de la barra de opciones que tiene el identificador de comando especificado.

CMFCRibbonPanel::SetElementRTC

Agrega un elemento de barra de opciones especificado por la información de la clase en tiempo de ejecución proporcionada al panel de la barra de opciones.

CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);

Parámetros

nIndex
[in] Especifica el índice de base cero del elemento de la barra de opciones que se va a añadir.

pRTC
[in, out] Un puntero a la información de la clase en tiempo de ejecución para el elemento de barra de opciones que se agrega al panel de la barra de opciones.

Valor devuelto

Elemento de barra de opciones que se creó mediante la información de la clase en tiempo de ejecución especificada.

Comentarios

Si deseas agregar un elemento personalizado (por ejemplo, un botón de color) al panel de la cinta de opciones, debes especificar la información de clase en tiempo de ejecución del elemento personalizado. La barra almacena esta información, crea el elemento personalizado y reemplaza un elemento existente que se encuentra (identificado por) el identificador de comando especificado. A continuación, la barra de opciones devuelve un puntero al elemento recién creado.

CMFCRibbonPanel::SetElementRTCByID

Agrega un elemento de barra de opciones especificado por la información de la clase en tiempo de ejecución proporcionada al panel de la barra de opciones.

CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);

Parámetros

uiCmdID
[in] Especifica el identificador de comando del elemento de la barra de opciones que se va a añadir.

pRTC
[in, out] Un puntero a la información de la clase en tiempo de ejecución asociado al elemento de barra de opciones que se agrega al panel de la barra de opciones.

Valor devuelto

Elemento de barra de opciones que se creó mediante la información de la clase en tiempo de ejecución especificada.

Comentarios

Si deseas agregar un elemento personalizado (por ejemplo, un botón de color) al panel de la cinta de opciones, debes especificar la información de clase en tiempo de ejecución del elemento personalizado. La barra de opciones almacena esta información, crea el elemento personalizado y sustituye un elemento existente localizado por el ID de comando especificado. A continuación, devuelve un puntero al elemento recién creado.

Ejemplo

En el siguiente ejemplo, se muestra cómo utilizar el método SetElementRTCByID:

// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:

pPanel->AddToolBar(IDR_MAINFRAME,
    IDB_MAINFRAME256);

CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
    RUNTIME_CLASS (CMFCRibbonColorButton));

// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
    which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
    RGB (0,
    0,
    0));

CMFCRibbonPanel::SetJustifyColumns

Habilita o deshabilita el ajuste del ancho de los elementos de la barra de opciones en la misma columna.

void SetJustifyColumns(BOOL bSet = TRUE);

Parámetros

bSet
[in] TRUE para ajustar el ancho de los elementos de la barra de opciones de la misma columna al ancho del elemento de barra de opciones más grande de la columna; FALSE para deshabilitar este ajuste de ancho.

Comentarios

Cuando esta característica está habilitada en un panel de barra de opciones, los anchos de los elementos de la cinta de opciones de la misma columna se ajustan al ancho del elemento de la barra de opciones más grande de la misma columna.

CMFCRibbonPanel::SetKeys

Establece la información sobre claves para el botón predeterminado del panel de la barra de opciones.

void SetKeys(LPCTSTR lpszKeys);

Parámetros

lpszKeys
[in] Información sobre claves del botón predeterminado del panel de la barra de opciones.

Comentarios

El botón predeterminado se muestra cuando un panel de cinta de opciones no tiene espacio suficiente para mostrar sus elementos de la barra de opciones.

CMFCRibbonPanel::ShowPopup

Crea y muestra un menú emergente para el panel de la barra de opciones.

CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);

Parámetros

pButton
[in] Un puntero al botón predeterminado del panel de la barra de opciones.

Valor devuelto

Puntero al menú emergente del panel de la barra de opciones si el método se realizó correctamente; en caso contrario, NULL.

Comentarios

El menú emergente del panel de la barra de opciones solo está disponible cuando se contrae la presentación del panel de la barra de opciones.

CMFCRibbonPanel::SetFocused

Establece el foco en el elemento de la barra de opciones especificado.

void SetFocused(CMFCRibbonBaseElement* pNewFocus);

Parámetros

pNewFocus
Un puntero a un elemento de la barra de opciones que recibe el foco.

Comentarios

CMFCRibbonPanel::MakeGalleryItemVisible

Desplaza la galería para que el elemento barra de opciones especificado esté visible.

void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);

Parámetros

pItem
[in] Un puntero a un elemento de la cinta.

Comentarios

CMFCRibbonPanel::IsWindows7Look

Indica si la cinta de opciones primaria tiene la apariencia de Windows 7 (botón de aplicación rectangular pequeño).

BOOL IsWindows7Look() const;

Valor devuelto

TRUE si la cinta primaria tiene la apariencia de Windows 7; de lo contrario, FALSE.

Comentarios

CMFCRibbonPanel::GetVisibleElements

Obtiene una matriz de elementos visibles.

void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);

Parámetros

arElements
Cuando la función devuelve, este parámetro contiene una matriz de elementos visibles.

Comentarios

CMFCRibbonPanel::GetGalleryRect

Devuelve un rectángulo delimitador del elemento Gallery.

CRect GetGalleryRect();

Valor devuelto

Tamaño y posición del elemento Gallery dentro de este panel.

Comentarios

CMFCRibbonPanel::GetFocused

Devuelve un elemento que tiene el foco.

CMFCRibbonBaseElement* GetFocused() const;

Valor devuelto

Puntero a un elemento centrado o NULL.

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CObject (clase)
CMFCRibbonCategory (clase)
CMFCRibbonBaseElement (clase)

Compartir a través de

Clase CMFCRibbonPanel

Sintaxis

Miembros

Constructores protegidos

Métodos públicos

Comentarios

Ejemplo

Jerarquía de herencia

Requisitos

CMFCRibbonPanel::Add

Parámetros

Comentarios

CMFCRibbonPanel::AddSeparator

Comentarios

CMFCRibbonPanel::AddToolBar

Parámetros

Valor devuelto

Comentarios

CMFCRibbonPanel::CMFCRibbonPanel

Parámetros

CMFCRibbonPanel::FindByData

Parámetros

Valor devuelto

Comentarios

CMFCRibbonPanel::FindByID

Parámetros

Valor devuelto

CMFCRibbonPanel::GetCaptionHeight

Valor devuelto

Comentarios

CMFCRibbonPanel::GetCount

Valor devuelto

CMFCRibbonPanel::GetData

Valor devuelto

CMFCRibbonPanel::GetDefaultButton

Valor devuelto

Comentarios

CMFCRibbonPanel::GetDroppedDown

Valor devuelto

Comentarios

CMFCRibbonPanel::GetElement

Parámetros

Valor devuelto

CMFCRibbonPanel::GetElements

Parámetros

Comentarios

CMFCRibbonPanel::GetElementsByID

Parámetros

Comentarios

CMFCRibbonPanel::GetHighlighted

Valor devuelto

Comentarios

CMFCRibbonPanel::GetIndex

Parámetros

Valor devuelto

Comentarios

CMFCRibbonPanel::GetItemIDsList

Parámetros

Comentarios

CMFCRibbonPanel::GetName

Valor devuelto

Comentarios

CMFCRibbonPanel::GetParentButton

Valor devuelto

Comentarios

CMFCRibbonPanel::GetParentCategory

Valor devuelto

CMFCRibbonPanel::GetParentMenuBar

Valor devuelto

Comentarios

CMFCRibbonPanel::GetPreferedMenuLocation

Parámetros

Valor devuelto

Comentarios

CMFCRibbonPanel::GetPressed

Valor devuelto

Comentarios

CMFCRibbonPanel::GetRect

Valor devuelto