Compartir a través de


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