Compartir a través de

CMFCRibbonEdit (clase)

  • Artículo

Implementa un control de edición que se coloca en una barra de la cinta de opciones.

Sintaxis

class CMFCRibbonEdit : public CMFCRibbonButton

Miembros

Constructores públicos

Nombre Descripción
CMFCRibbonEdit::CMFCRibbonEdit Construye un objeto CMFCRibbonEdit.

Métodos públicos

Nombre Descripción
CMFCRibbonEdit::CanBeStretched Indica si el alto del elemento del control CMFCRibbonEdit puede aumentar verticalmente al alto de una fila de la cinta.
CMFCRibbonEdit::CMFCRibbonEdit Construye un objeto CMFCRibbonEdit.
CMFCRibbonEdit::CopyFrom Copia el estado del objeto especificado CMFCRibbonEdit en el objeto CMFCRibbonEdit actual.
CMFCRibbonEdit::CreateEdit Crea un nuevo cuadro de texto del objeto CMFCRibbonEdit.
CMFCRibbonEdit::DestroyCtrl Destruye el objeto CMFCRibbonEdit.
CMFCRibbonEdit::DropDownList Despliega un cuadro de lista.
CMFCRibbonEdit::EnableSpinButtons Habilita y establece el intervalo del botón de número del cuadro de texto.
CMFCRibbonEdit::GetCompactSize Recupera el tamaño compacto del objeto CFMCRibbonEdit.
CMFCRibbonEdit::GetEditText Recupera el texto del cuadro de texto.
CMFCRibbonEdit::GetIntermediateSize Recupera el tamaño intermedio del objeto CMFCRibbonEdit.
CMFCRibbonEdit::GetTextAlign Recupera el texto de alineación del cuadro de texto.
CMFCRibbonEdit::GetWidth Recupera el ancho en píxeles del control CMFCRibbonEdit.
CMFCRibbonEdit::HasCompactMode Indica si el tamaño de presentación del control CMFCRibbonEditpuede ser compacto.
CMFCRibbonEdit::HasFocus Indica si el control CMFCRIbbonEdit tiene el foco.
CMFCRibbonEdit::HasLargeMode Indica si el tamaño de presentación del control CMFCRibbonEditpuede ser amplio.
CMFCRibbonEdit::HasSpinButtons Indica si el cuadro de texto tiene un botón de número.
CMFCRibbonEdit::IsHighlighted Indica si el control CMFCRibbonEdit está destacado.
CMFCRibbonEdit::OnAfterChangeRect Lo llama el marco cuando se cambian las dimensiones del rectángulo de presentación para los cambios del control CMFCRibbonEdit.
CMFCRibbonEdit::OnDraw Lo llama el marco para dibujar el control CMFCRibbonEdit.
CMFCRibbonEdit::OnDrawLabelAndImage Lo llama el marco para dibujar la etiqueta y la imagen del control CMFCRibbonEdit.
CMFCRibbonEdit::OnDrawOnList Lo llama el marco para dibujar el control CMFCRibbonEdit del cuadro de lista de comandos.
CMFCRibbonEdit::OnEnable Lo llama el marco para habilitar o deshabilitar el control CMFCRibbonEdit.
CMFCRibbonEdit::OnHighlight Lo llama el marco cuando el puntero entra o sale de los límites del control CMFCRibbonEdit.
CMFCRibbonEdit::OnKey Lo llama el marco cuando el usuario presiona una información sobre teclas y el control CMFCRibbonEdit tiene el foco.
CMFCRibbonEdit::OnLButtonDown Lo llama el marco para actualizar el control CMFCRibbonEdit cuando se presiona el botón izquierdo del mouse en el control.
CMFCRibbonEdit::OnLButtonUp Lo llama el marco cuando se suelta el botón izquierdo del mouse.
CMFCRibbonEdit::OnRTLChanged Lo llama el marco para actualizar el control CMFCRibbonEdit cuando se cambia la dirección del diseño.
CMFCRibbonEdit::OnShow Lo llama el marco para mostrar u ocultar el control CMFCRibbonEdit.
CMFCRibbonEdit::Redraw Actualiza la presentación del control CMFCRibbonEdit.
CMFCRibbonEdit::SetACCData Establece los datos de accesibilidad del objeto CMFCRibbonEdit.
CMFCRibbonEdit::SetEditText Establece el texto del cuadro de texto.
CMFCRibbonEdit::SetTextAlign Establece la alineación del texto del cuadro de texto.
CMFCRibbonEdit::SetWidth Establece el ancho del cuadro de texto del control CMFCRibbonEdit.

Comentarios

Ejemplo

En el ejemplo siguiente se muestra cómo construir un objeto CMFCRibbonEdit, mostrar botones de número junto al control de edición y establecer el texto del control de edición. Este fragmento de código forma parte del ejemplo de demostración de MS Office 2007.

CMFCRibbonEdit *pEditIndentLeft = new CMFCRibbonEdit(ID_PAGELAYOUT_INDENT_LEFT, 72, _T("Left:\nil"), 13);
// specify the min and max value of the spin button control
pEditIndentLeft->EnableSpinButtons(0, 1000);
// set the text of the edit control
pEditIndentLeft->SetEditText(_T("0"));

Requisitos

Encabezado: afxRibbonEdit.h

CMFCRibbonEdit::CanBeStretched

Indica si el alto del elemento del control CMFCRibbonEdit puede aumentar verticalmente al alto de una fila de la cinta.

virtual BOOL CanBeStretched();

Valor devuelto

Siempre devuelve FALSE.

Comentarios

CMFCRibbonEdit::CMFCRibbonEdit

Construye un objeto CMFCRibbonEdit.

CMFCRibbonEdit(
    UINT nID,
    int nWidth,
    LPCTSTR lpszLabel = NULL,
    int nImage = -1);

CMFCRibbonEdit();

Parámetros

Nid
[in] Id. del comando del control CMFCRibbonEdit.

nWidth
[in] Ancho expresado píxeles del cuadro de texto del control CMFCRibbonEdit.

lpszLabel
[in] Etiqueta del control CMFCRibbonEdit.

nImage
[in] Índice de la imagen pequeña que se va a usar en el control CMFCRibbonEdit. La categoría de cinta primaria mantiene la colección de imágenes pequeñas.

Comentarios

El control CMFCRibbonEdit no emplea una imagen grande.

CMFCRibbonEdit::CopyFrom

Copia el estado del objeto CMFCRibbonEdit especificado en el objeto CMFCRibbonEdit actual.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parámetros

src
[in] El objeto CMFCRibbonEdit de origen.

Comentarios

Este parámetro src debe ser del tipo CMFCRibbonEdit.

CMFCRibbonEdit::CreateEdit

Crea un nuevo cuadro de texto para el objeto CMFCRibbonEdit .

virtual CMFCRibbonRichEditCtrl* CreateEdit(
    CWnd* pWndParent,
    DWORD dwEditStyle);

Parámetros

pWndParent
[Entrada] El valor de este parámetro se corresponde con un puntero que apunta a la ventana primaria del objeto CMFCRibbonEdit.

dwEditStyle
[in] Especifica el estilo del cuadro de texto. Se pueden combinar los estilos de ventana que aparecen en la sección Comentarios con los estilos de control de edición descritos en Windows SDK.

Valor devuelto

Puntero que apunta al nuevo cuadro de texto si el método se aplicó correctamente, en caso contrario NULL.

Comentarios

Invalide este método en una clase derivada si desea crear un cuadro de texto personalizado.

Se pueden aplicar los siguientes estilos de ventana a un cuadro de texto:

  • WS_CHILD

  • WS_VISIBLE

  • WS_DISABLED

  • WS_GROUP

  • WS_TABSTOP

CMFCRibbonEdit::DestroyCtrl

Destruye un objeto CMFCRibbonEdit.

virtual void DestroyCtrl();

Comentarios

Despliega un cuadro de lista.

virtual void DropDownList();

Comentarios

De forma predeterminada, este método no hace nada. Invalide este método si desea desplegar un cuadro de lista.

CMFCRibbonEdit::EnableSpinButtons

Habilita y establece el intervalo del botón de número del cuadro de texto.

void EnableSpinButtons(
    int nMin,
    int nMax);

Parámetros

nMin
[in] Valor mínimo del botón de número.

nMax
[in] Valor máximo del botón de número.

Comentarios

Los botones de número muestran una flecha arriba y abajo con la se puede desplazar por un conjunto fijo de valores.

CMFCRibbonEdit::GetCompactSize

Recupera el tamaño compacto del objeto CMFCRibbonEdit.

virtual CSize GetCompactSize(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo para el objeto CMFCRibbonEdit.

Valor devuelto

Tamaño compacto del objeto CMFCRibbonEdit.

Comentarios

CMFCRibbonEdit::GetEditText

Recupera el texto del cuadro de texto.

CString GetEditText() const;

Valor devuelto

Texto del cuadro de texto.

Comentarios

CMFCRibbonEdit::GetIntermediateSize

Recupera el tamaño intermedio del objeto CMFCRibbonEdit .

virtual CSize GetIntermediateSize(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo para el objeto CMFCRibbonEdit.

Valor devuelto

Tamaño intermedio del objeto CMFCRibbonEdit.

Comentarios

CMFCRibbonEdit::GetTextAlign

Recupera el texto de alineación del cuadro de texto.

int GetTextAlign() const;

Valor devuelto

Valor enumerado de alineación de texto. Consulte la sección Comentarios para ver los valores posibles.

Comentarios

El valor devuelto es uno de los estilos de control de edición que figuran a continuación:

  • ES_LEFT para alinear a la izquierda

  • ES_CENTER para alinear al centro

  • ES_RIGHT para alinear a la derecha

Si desea más información sobre estos estilos, consulte Editar estilos de control.

CMFCRibbonEdit::GetWidth

Recupera el ancho en píxeles del control CMFCRibbonEdit .

int GetWidth(BOOL bInFloatyMode = FALSE) const;

Parámetros

bInFloatyMode
[in] TRUE si el control CMFCRibbonEdit está en modo flotante; de lo contrario, FALSE.

Valor devuelto

Ancho expresado en píxeles del control CMFCRibbonEdit.

Comentarios

CMFCRibbonEdit::HasCompactMode

Indica si el tamaño de presentación del control CMFCRibbonEdit puede ser compacto.

virtual BOOL HasCompactMode() const;

Valor devuelto

Siempre devuelve TRUE.

Comentarios

De forma predeterminada, este método siempre devuelve TRUE. Invalide el método para indicar si el tamaño de presentación puede ser compacto.

CMFCRibbonEdit::HasFocus

Indica si el control CMFCRibbonEdit tiene el foco.

virtual BOOL HasFocus() const;

Valor devuelto

TRUE si el control CMFCRibbonEdit tiene el foco; en caso contrario, FALSE.

Comentarios

CMFCRibbonEdit::HasLargeMode

Indica si el tamaño de pantalla de presentación del control CMFCRibbonEdit puede ser grande.

virtual BOOL HasLargeMode() const;

Valor devuelto

Siempre devuelve FALSE.

Comentarios

De forma predeterminada, este método siempre devuelve FALSE. Invalide el método para indicar si el tamaño de presentación puede ser grande.

CMFCRibbonEdit::HasSpinButtons

Indica si el cuadro de texto tiene un botón de número.

virtual BOOL HasSpinButtons() const;

Valor devuelto

TRUE si el cuadro de texto cuenta con un botón de número; en caso contrario, FALSE.

Comentarios

CMFCRibbonEdit::IsHighlighted

Indica si se resalta el control CMFCRibbonEdit.

virtual BOOL IsHighlighted() const;

Valor devuelto

TRUE si se resalta el control CMFCRibbonEdit; en caso contrario, FALSE.

Comentarios

CMFCRibbonEdit::OnAfterChangeRect

Lo llama el marco cuando se cambian las dimensiones del rectángulo de presentación para los cambios del control CMFCRibbonEdit.

virtual void OnAfterChangeRect(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo para el control CMFCRibbonEdit.

Comentarios

CMFCRibbonEdit::OnDraw

Lo llama el marco para dibujar el control CMFCRibbonEdit.

virtual void OnDraw(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo para el control CMFCRibbonEdit.

Comentarios

CMFCRibbonEdit::OnDrawLabelAndImage

Lo llama el marco para dibujar la etiqueta y la imagen del control CMFCRibbonEdit.

virtual void OnDrawLabelAndImage(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo para el control CMFCRibbonEdit.

Comentarios

CMFCRibbonEdit::OnDrawOnList

Lo llama el marco para dibujar el control CMFCRibbonEdit del cuadro de lista de comandos.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo para el control CMFCRibbonEdit.

strText
[in] Texto para mostrar.

nTextOffset
[in] Distancia, en píxeles, desde el lado izquierdo del cuadro de la lista hasta el texto para mostrar.

rect
[in] Rectángulo de presentación del control CMFCRibbonEdit.

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

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

Comentarios

El cuadro de lista de comandos muestra los controles con los que se puede personalizar la barra de herramientas de acceso rápido.

CMFCRibbonEdit::OnEnable

Lo llama el marco para habilitar o deshabilitar el control CMFCRibbonEdit.

virtual void OnEnable(BOOL bEnable);

Parámetros

bEnable
[in] TRUE para habilitar el control; FALSE para deshabilitar el control.

Comentarios

CMFCRibbonEdit::OnHighlight

Lo llama el marco cuando el puntero entra o sale de los límites del control CMFCRibbonEdit.

virtual void OnHighlight(BOOL bHighlight);

Parámetros

bHighlight
[in] TRUE si el puntero está en los límites del control CMFCRibbonEdit; de lo contrario, FALSE.

Comentarios

CMFCRibbonEdit::OnKey

Lo llama el marco cuando se presiona una información sobre teclas y el control CMFCRibbonEdit tiene el foco.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parámetros

bIsMenuKey
[in] TRUE si la información sobre teclas muestra un menú emergente; en caso contrario, se devuelve el valor FALSE.

Valor devuelto

TRUE si el evento se ha controlado; en caso contrario, se devuelve el valor FALSE.

Comentarios

CMFCRibbonEdit::OnLButtonDown

Lo llama el marco para actualizar el control CMFCRibbonEdit cuando se presiona el botón izquierdo del mouse en el control.

virtual void OnLButtonDown(CPoint point);

Parámetros

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

Comentarios

CMFCRibbonEdit::OnLButtonUp

Lo llama el marco cuando se suelta el botón izquierdo del mouse.

virtual void OnLButtonUp(CPoint point);

Parámetros

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

Comentarios

CMFCRibbonEdit::OnRTLChanged

Lo llama el marco para actualizar el control CMFCRibbonEdit cuando se cambia la dirección del diseño.

virtual void OnRTLChanged(BOOL bIsRTL);

Parámetros

bIsRTL
[in] TRUE si el diseño está de derecha a izquierda; FALSE si el diseño está de izquierda a derecha.

Comentarios

CMFCRibbonEdit::OnShow

Lo llama el marco para mostrar u ocultar el control CMFCRibbonEdit.

virtual void OnShow(BOOL bShow);

Parámetros

bShow
[in] TRUE para mostrar el control; FALSE para ocultarlo.

Comentarios

CMFCRibbonEdit::Redraw

Actualiza la presentación del control CMFCRibbonEdit.

virtual void Redraw();

Comentarios

Este método vuelve a dibujar el rectángulo de presentación del objeto CMFCRibbonEdit al llamar indirectamente a CWnd::RedrawWindow con las marcas RDW_INVALIDATE, RDW_ERASE y RDW_UPDATENOW establecidas.

CMFCRibbonEdit::SetACCData

Establece los datos de accesibilidad del objeto CMFCRibbonEdit.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parámetros

pParent
Puntero que apunta a la ventana primaria del objeto CMFCRibbonEdit.

data
Datos de accesibilidad del objeto CMFCRibbonEdit.

Valor devuelto

Siempre devuelve TRUE.

Comentarios

CMFCRibbonEdit::SetEditText

Establece el texto del cuadro de texto.

void SetEditText(CString strText);

Parámetros

strText
[in] Texto del cuadro de texto.

CMFCRibbonEdit::SetTextAlign

Establece la alineación del texto del cuadro de texto.

void SetTextAlign(int nAlign);

Parámetros

nAlign
[in] Valor enumerado de alineación de texto. Consulte la sección Comentarios para ver los valores posibles.

Comentarios

El parámetro nAlign es uno de los siguientes estilos del control de edición:

  • ES_LEFT para alinear a la izquierda

  • ES_CENTER para alinear al centro

  • ES_RIGHT para alinear a la derecha

Si desea más información sobre estos estilos, consulte Editar estilos de control.

CMFCRibbonEdit::SetWidth

Establece el ancho del cuadro de texto del control CMFCRibbonEdit .

void SetWidth(
    int nWidth,
    BOOL bInFloatyMode = FALSE);

Parámetros

nWidth
[in] Ancho del cuadro de texto, expresado en píxeles.

bInFloatyMode
TRUE para establecer el ancho del modo flotante; FALSE para establecer el ancho del modo normal.

Comentarios

El control CMFCRibbonEdit tiene dos anchos en función de su modo de presentación: modo flotante o regular.

Consulte también

Gráfico de jerarquías
Clases
CMFCRibbonButton (clase)
CMFCRibbonBar (clase)