CMFCRibbonBaseElement Class

La clase de CMFCRibbonBaseElement es la clase base para todos los elementos que puede agregar a barra de la cinta de opciones. Los ejemplos de elementos de la cinta de opciones son botones de la cinta de opciones, las casillas de la cinta de opciones, y cuadros combinados de la cinta de opciones.

class CMFCRibbonBaseElement : public CObject

Members

Constructores públicos

Name	Descripción
CMFCRibbonBaseElement	Crea un objeto CMFCRibbonBaseElement.

Métodos públicos

Name	Descripción
CMFCRibbonBaseElement::AddToKeyList	Agrega un keytip para el elemento cinta a una matriz de keytips.
CMFCRibbonBaseElement::AddToListBox	Agrega un elemento cinta al cuadro de lista especificado de los comandos de la cinta de opciones.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar	Indica si el elemento cinta se puede agregar a la barra de herramientas de acceso rápido.
CMFCRibbonBaseElement::CanBeCompacted	Indica si el tamaño del elemento cinta puede ser compacto.
CMFCRibbonBaseElement::CanBeStretched	Indica si el alto del elemento cinta puede aumentar verticalmente el alto de una fila de la cinta de opciones.
CMFCRibbonBaseElement::CanBeStretchedHorizontally	Indica si el ancho del elemento cinta puede cambiar.
CMFCRibbonBaseElement::CleanUpSizes	Limpia los valores de dimensión para el elemento cinta.
CMFCRibbonBaseElement::ClosePopupMenu	Cierre el elemento emergente del elemento cinta.
CMFCRibbonBaseElement::CopyFrom	Copia el estado de CMFCRibbonBaseElement especificado al objeto actual.
CMFCRibbonBaseElement::DestroyCtrl	Destruye el elemento cinta.
CMFCRibbonBaseElement::DrawImage	Dibuja la imagen para el elemento cinta.
CMFCRibbonBaseElement::Find	Devuelve el puntero especificado al elemento cinta si señala al objeto actual.
CMFCRibbonBaseElement::FindByData	Recupera un puntero al elemento cinta si contiene los datos especificados.
CMFCRibbonBaseElement::FindByID	Recupera un puntero al elemento cinta si ese elemento se identifica mediante el identificador especificado de comando
CMFCRibbonBaseElement::FindByOriginal	Recupera un puntero al elemento cinta si las coincidencias originales del elemento cinta el elemento especificado de la cinta de opciones.
CMFCRibbonBaseElement::GetCompactSize	Devuelve el tamaño compacto de elemento cinta.
CMFCRibbonBaseElement::GetData	Recupera los datos definidos por el usuario asociados al elemento cinta.
CMFCRibbonBaseElement::GetDescription	Devuelve la descripción del elemento cinta.
CMFCRibbonBaseElement::GetDroppedDown	Recupera un puntero al elemento cinta si el elemento emergente se quita a continuación.
CMFCRibbonBaseElement::GetElements	Agrega el elemento actual de la cinta de opciones en la matriz especificada.
CMFCRibbonBaseElement::GetElementsByID	Agrega el elemento actual de la cinta de opciones en la matriz especificada si el elemento actual de la cinta de opciones contiene el identificador especificado de comando
CMFCRibbonBaseElement::GetHighlighted	Recupera un puntero al elemento cinta si es resaltado.
CMFCRibbonBaseElement::GetID	Devuelve el identificador del elemento cinta.
CMFCRibbonBaseElement::GetImageSize	Devuelve el tamaño de la imagen del elemento cinta.
CMFCRibbonBaseElement::GetIntermediateSize	Devuelve el tamaño del elemento cinta en su estado intermedia.
CMFCRibbonBaseElement::GetKeys	Devuelve el keytip asociado con el elemento cinta.
CMFCRibbonBaseElement::GetKeyTipRect	Recupera el rectángulo de selección de keytip para el elemento cinta.
CMFCRibbonBaseElement::GetKeyTipSize	Recupera el tamaño del texto de keytip.
CMFCRibbonBaseElement::GetLocationInGroup	Indica la ubicación de la presentación del elemento cinta en un grupo de la cinta de opciones.
CMFCRibbonBaseElement::GetMenuKeys	Devuelve los keytips asociados a un botón.
CMFCRibbonBaseElement::GetNotifyID	Recupera el id. de comando de notificación para el elemento cinta.
CMFCRibbonBaseElement::GetOriginal	Recupera el elemento original de la cinta de opciones.
CMFCRibbonBaseElement::GetParentCategory	Recupera la categoría de la cinta de opciones para el elemento cinta.
CMFCRibbonBaseElement::GetParentPanel	Recupera el panel de la cinta que contiene el elemento cinta.
CMFCRibbonBaseElement::GetParentRibbonBar	Recupera la barra primaria de la cinta de opciones para el elemento cinta.
CMFCRibbonBaseElement::GetParentWnd	Recupera la ventana primaria para el elemento cinta.
CMFCRibbonBaseElement::GetPressed	Recupera un puntero al elemento cinta si el usuario se presiona actualmente.
CMFCRibbonBaseElement::GetQuickAccessToolBarID	Recupera el identificador del elemento cinta cuando se encuentra en la barra de herramientas de acceso rápido.
CMFCRibbonBaseElement::GetRect	Devuelve el rectángulo delimitador del elemento cinta.
CMFCRibbonBaseElement::GetRegularSize	Devuelve el tamaño normal del elemento cinta.
CMFCRibbonBaseElement::GetSize	Devuelve el tamaño actual del elemento cinta.
CMFCRibbonBaseElement::GetText	Devuelve el texto asociado al elemento cinta.
CMFCRibbonBaseElement::GetToolTipText	Devuelve el texto de información sobre herramientas del elemento cinta.
CMFCRibbonBaseElement::GetTopLevelRibbonBar	Recupera la barra de la cinta de opciones de nivel superior para el elemento cinta.
CMFCRibbonBaseElement::HasCompactMode	Especifica si el elemento cinta tiene un modo compacto.
CMFCRibbonBaseElement::HasFocus	Indica si el elemento primario tiene el foco de teclado.
CMFCRibbonBaseElement::HasIntermediateMode	Especifica si el elemento cinta tiene un modo intermedio.
CMFCRibbonBaseElement::HasLargeMode	Especifica si el elemento cinta tiene un modo grande.
CMFCRibbonBaseElement::HasMenu	Indica si el elemento cinta tiene un menú.
CMFCRibbonBaseElement::HitTest	Recupera un puntero al elemento cinta si el punto especificado se encuentra en él.
CMFCRibbonBaseElement::IsAlignByColumn	Indica si el elemento cinta está alineado verticalmente con otros elementos de cinta de opciones.
CMFCRibbonBaseElement::IsAlwaysLargeImage	Indica si el tamaño de la imagen del elemento cinta siempre es grande.
CMFCRibbonBaseElement::IsAutoRepeatMode	Indica si el elemento cinta está en modo de repetición automática.
CMFCRibbonBaseElement::IsChecked	Especifica si el elemento cinta está activado.
CMFCRibbonBaseElement::IsCompactMode	Especifica si el elemento cinta está en un modo compacto.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled	Especifica si el elemento cinta está deshabilitado.
CMFCRibbonBaseElement::IsDroppedDown	Determina si el elemento cinta muestra un menú emergente y se divide a continuación.
CMFCRibbonBaseElement::IsFocused	Especifica si el elemento cinta tiene el foco.
CMFCRibbonBaseElement::IsGalleryIcon	Indica si el elemento cinta está contenido en una galería de la cinta de opciones.
CMFCRibbonBaseElement::IsHighlighted	Especifica si el elemento cinta aparecerá resaltada.
CMFCRibbonBaseElement::IsIntermediateMode	Indica si la imagen actual para el elemento cinta es tamaño intermedio.
CMFCRibbonBaseElement::IsLargeMode	Indica si la imagen actual para el elemento cinta es de gran tamaño.
CMFCRibbonBaseElement::IsMenuMode	Indica si el elemento cinta está contenido en un menú.
CMFCRibbonBaseElement::IsPressed	Indica si el usuario ha hecho clic en el elemento cinta.
CMFCRibbonBaseElement::IsQATMode	Indica si el elemento cinta está contenido en la barra de herramientas de acceso rápido.
CMFCRibbonBaseElement::IsSeparator	Indica si el elemento cinta es un separador de la pantalla.
CMFCRibbonBaseElement::IsShowGroupBorder	Indica si el elemento cinta está contenido en un grupo que muestra un borde común.
CMFCRibbonBaseElement::IsShowTooltipOnBottom	Indica si la información sobre herramientas se muestra bajo el elemento cinta.
CMFCRibbonBaseElement::IsTabStop	Indica si el elemento cinta puede seleccionar con el teclado.
CMFCRibbonBaseElement::IsTextAlwaysOnRight	Indica si el texto para el elemento cinta aparece a la derecha.
CMFCRibbonBaseElement::IsVisible	Indica si el elemento cinta se muestra actualmente.
CMFCRibbonBaseElement::IsWholeRowHeight	Indica si el heigth de presentación del elemento cinta es igual que el alto de la pantalla del panel de la cinta que lo contiene.
CMFCRibbonBaseElement::NotifyCommand	Envía una notificación de comando a la ventana principal del elemento cinta.
CMFCRibbonBaseElement::NotifyHighlightListItem	Notifica a la ventana primaria de la barra de la cinta de opciones a un usuario se resalta el elemento cinta que se encuentra en una lista.
CMFCRibbonBaseElement::OnAddToQAToolbar	Agrega el elemento cinta a la barra de herramientas especificada de acceso rápido.
CMFCRibbonBaseElement::OnAfterChangeRect	Actualiza la información sobre herramientas para el elemento cinta.
CMFCRibbonBaseElement::OnAutoRepeat	Actualiza el elemento cinta en respuesta a los datos proporcionados por el usuario continuo.
CMFCRibbonBaseElement::OnCalcTextSize	Calcula el tamaño del texto para el elemento cinta.
CMFCRibbonBaseElement::OnChangeMenuHighlight	Llamado por el marco cuando el resaltado de un elemento cinta que se encuentra en un menú.
CMFCRibbonBaseElement::OnDraw	Llamado por el marco para dibujar el elemento cinta.
CMFCRibbonBaseElement::OnDrawKeyTip	Llamado por el marco para dibujar el keytip para el elemento cinta.
CMFCRibbonBaseElement::OnDrawMenuImage	Llamado por el marco cuando la imagen del menú para el elemento cinta se dibuja.
CMFCRibbonBaseElement::OnDrawOnList	Llamado por el marco para dibujar el elemento cinta en un cuadro de lista de comandos.
CMFCRibbonBaseElement::OnKey	Llamado por el marco cuando el usuario presiona un keytip y el elemento cinta tiene el foco.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged	Llamado por el marco cuando el diseño cambia la dirección.
CMFCRibbonBaseElement::OnShow	Llamado por el marco para mostrar u ocultar el elemento cinta.
CMFCRibbonBaseElement::OnShowPopupMenu	Llamado por el marco cuando el elemento cinta va a mostrar un menú emergente.
CMFCRibbonBaseElement::PostMenuCommand
CMFCRibbonBaseElement::Redraw	Actualiza la presentación para el elemento cinta.
CMFCRibbonBaseElement::SetACCData	Establece los datos de accesibilidad para el elemento cinta.
CMFCRibbonBaseElement::SetCompactMode	Establece el tamaño de presentación para el elemento cinta.
CMFCRibbonBaseElement::SetData	Asocia un elemento de datos al elemento cinta.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription	Establece la descripción para el elemento cinta.
CMFCRibbonBaseElement::SetID	Establece el identificador del elemento cinta.
CMFCRibbonBaseElement::SetInitialMode	Establece el tamaño inicial de presentación para el elemento cinta.
CMFCRibbonBaseElement::SetKeys	Establece un keytip para el elemento cinta.
CMFCRibbonBaseElement::SetOriginal	Establece el elemento original de la cinta de opciones para el elemento cinta.
CMFCRibbonBaseElement::SetParentCategory	Establece la categoría primaria para el elemento cinta.
CMFCRibbonBaseElement::SetParentMenu	Establece el contenedor de menú primario para el elemento cinta.
CMFCRibbonBaseElement::SetParentRibbonBar	Establece la barra primaria de la cinta de opciones para el elemento cinta.
CMFCRibbonBaseElement::SetRect	Establece las dimensiones que se muestra fot el rectángulo para el elemento cinta.
CMFCRibbonBaseElement::SetText	Establece el texto para el elemento cinta.
CMFCRibbonBaseElement::SetTextAlwaysOnRight	Establece el texto del elemento cinta muestra a la derecha.
CMFCRibbonBaseElement::SetToolTipText	Establece el texto de información sobre herramientas para el elemento cinta.
CMFCRibbonBaseElement::SetVisible	Establece el estado de visibilidad del elemento cinta.
CMFCRibbonBaseElement::StretchHorizontally	Expande el ancho del elemento cinta.
CMFCRibbonBaseElement::StretchToWholeRow	Cambia el alto de la presentación de un elemento de la cinta de opciones al alto de fila especificado.
CMFCRibbonBaseElement::UpdateTooltipInfo	Actualiza el texto de información sobre herramientas mediante el recurso de comando para el elemento cinta.

Métodos protegidos

Name	Descripción
CMFCRibbonBaseElement::OnProcessKey	Llamado por el marco cuando el usuario presiona una tecla de método abreviado.
CMFCRibbonBaseElement::OnSetFocus	Llamado por el marco cuando un elemento cinta recibe o pierde el foco de entrada.

Comentarios

La clase de CMFCRibbonBaseElement define las propiedades que son comunes a todos los elementos de la cinta de opciones que incluyen id. del comando, el etiqueta de texto, el texto de información sobre herramientas, la descripción del elemento, y estado (que puede ser detallada, ser resaltada, ser presionado, deshabilitar, comprobarse, o se interrumpe a continuación).

El tamaño de la imagen de un elemento cinta lo define el miembro de RibbonImageType , que puede ser uno de los siguientes valores:

• RibbonImageLarge

• RibbonImageSmall

Dependiendo de su tamaño, un elemento cinta muestra una imagen pequeña o grande.

Ejemplo

El ejemplo siguiente se muestra cómo utilizar varios métodos en la clase de CMFCRibbonBaseElement . El ejemplo muestra cómo obtener un objeto de CMFCRibbonBaseElement de una clase de CMFCRibbonStatusBar , establece la descripción para el elemento cinta, establece el texto, establece un keytip, y establece el texto de información sobre herramientas para el elemento cinta. Este fragmento de código es parte de Ejemplo de cliente de dibujo.

   // CMFCRibbonStatusBar m_wndStatusBar
    CMFCRibbonBaseElement* pPane = m_wndStatusBar.FindByID(nID);


...


        pPane->SetDescription(_T("a pane"));
        // CString strText
        pPane->SetText(strText);
        pPane->SetKeys(_T("p"));
        pPane->SetToolTipText(_T("this is a pane"));

Jerarquía de herencia

CObject

   CMFCRibbonBaseElement

Requisitos

encabezado: afxbaseribbonelement.h

Vea también

Referencia

Gráfico de jerarquías

Otros recursos

Clases de MFC