CMFCRibbonEdit (clase)
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
CMFCRibbonEdit::DropDownList
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)
Comentarios
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte: https://aka.ms/ContentUserFeedback.
Enviar e ver os comentarios