CMFCRibbonSlider (clase)
La clase CMFCRibbonSlider implementa un control deslizante que puede agregar a una barra de la cinta o una barra de estado de la cinta. El control deslizante de la cinta es similar a los controles deslizantes del zoom que aparecen en las aplicaciones de Office 2007.
Sintaxis
class CMFCRibbonSlider : public CMFCRibbonBaseElement
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CMFCRibbonSlider::CMFCRibbonSlider | Construye e inicializa un control deslizante de la cinta. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CMFCRibbonSlider::GetPos | Devuelve la posición actual del control deslizante. |
| CMFCRibbonSlider::GetRangeMax | Devuelve el valor máximo del control deslizante. |
| CMFCRibbonSlider::GetRangeMin | Devuelve el valor mínimo del control deslizante. |
| CMFCRibbonSlider::GetRegularSize | Devuelve el tamaño normal del elemento de la cinta. (Invalida CMFCRibbonBaseElement::GetRegularSize.) |
| CMFCRibbonSlider::GetZoomIncrement | Devuelve el tamaño del incremento del zoom del control deslizante. |
| CMFCRibbonSlider::HasZoomButtons | Especifica si el control deslizante tiene botones de zoom. |
| CMFCRibbonSlider::OnDraw | Llamado por el marco de trabajo para dibujar el elemento de la cinta. (Invalida CMFCRibbonBaseElement::OnDraw.) |
| CMFCRibbonSlider::SetPos | Establece la posición actual del control deslizante. |
| CMFCRibbonSlider::SetRange | Especifica el intervalo del control deslizante al establecer los valores mínimo y máximo. |
| CMFCRibbonSlider::SetZoomButtons | Muestra u oculta los botones de Zoom. |
| CMFCRibbonSlider::SetZoomIncrement | Establece el tamaño del incremento del zoom del control deslizante. |
Comentarios
Puede usar el método SetRange para configurar el intervalo de incrementos para el control deslizante. El método SetPos permite establecer la posición actual del control deslizante.
El método SetZoomButtons permite mostrar botones de zoom circulares en el lado izquierdo y derecho del control deslizante. De forma predeterminada, el control deslizante es horizontal, el botón de zoom de la izquierda muestra el signo de menos y el botón de zoom de la derecha muestra el signo de más.
El método SetZoomIncrement define el incremento que se va sumar o a restar de la posición actual cuando un usuario hace clic en un botón del zoom.
Ejemplo
En el ejemplo siguiente se muestra cómo usar varios métodos en la clase CMFCRibbonSlider para establecer las propiedades del control deslizante. En el ejemplo se muestra cómo construir un objeto CMFCRibbonSlider, mostrar los botones de zoom, establecer la posición actual del control deslizante y establecer el intervalo de valores del control deslizante.
// Create a ribbon slider.
CMFCRibbonSlider *ribbonSlider = new CMFCRibbonSlider();
// Set the various properties of the slider.
ribbonSlider->SetZoomButtons(true);
ribbonSlider->SetPos(50, TRUE);
ribbonSlider->SetRange(0, 100);
// Add the ribbon slider to the Favorites panel.
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(ribbonSlider);
Jerarquía de herencia
Requisitos
Encabezado: afxribbonslider.h
CMFCRibbonSlider::CMFCRibbonSlider
Construye un control deslizante de la cinta de opciones.
CMFCRibbonSlider(
UINT nID,
int nWidth=100);
Parámetros
Nid
[in] Id. del control deslizante.
[in]. nWidth Control deslizante width en píxeles.
Comentarios
Construye un control deslizante de la cinta de opciones con un ancho de nWidth píxeles en la categoría del panel donde se agrega el control deslizante. De forma predeterminada, el control deslizante es horizontal.
CMFCRibbonSlider::GetPos
Devuelve la posición actual del control deslizante.
int GetPos() const;
Valor devuelto
La posición actual del control deslizante, que es relativa al principio del control deslizante.
CMFCRibbonSlider::GetRangeMax
Obtiene el incremento máximo del control deslizante que el control deslizante puede desplazarse en el control deslizante.
int GetRangeMax() const;
Valor devuelto
El incremento máximo del control deslizante que el control puede desplazarse en el control deslizante.
CMFCRibbonSlider::GetRangeMin
Devuelve el incremento mínimo que el control deslizante puede desplazarse en el control deslizante.
int GetRangeMin() const;
Valor devuelto
El incremento mínimo que el control deslizante puede desplazarse en el control deslizante.
CMFCRibbonSlider::GetRegularSize
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.
virtual CSize GetRegularSize(CDC* pDC);
Parámetros
[in] pDC
Valor devuelto
Comentarios
CMFCRibbonSlider::GetZoomIncrement
Obtiene el tamaño del incremento del zoom del control deslizante.
int GetZoomIncrement() const;
Valor devuelto
El incremento del zoom del control deslizante.
CMFCRibbonSlider::HasZoomButtons
Especifica si el control deslizante tiene botones de zoom.
BOOL HasZoomButtons() const;
Valor devuelto
TRUE si el control deslizante tiene botones de zoom, FALSE en caso contrario.
CMFCRibbonSlider::OnDraw
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.
virtual void OnDraw(CDC* pDC);
Parámetros
[in] pDC
Comentarios
CMFCRibbonSlider::SetPos
Establece la posición actual del control deslizante.
void SetPos(
int nPos,
BOOL bRedraw=TRUE);
Parámetros
nPos
[in] Especifica la posición que se va a establecer para el control deslizante. La posición es relativa al principio del control deslizante.
bRedraw
[in] Si es TRUE, el control deslizante se dibujará de nuevo.
CMFCRibbonSlider::SetRange
Establece el intervalo de valores para el control deslizante.
void SetRange(
int nMin,
int nMax);
Parámetros
nMin
[in] Especifica el valor mínimo del control deslizante.
nMax
[in] Especifica el valor máximo del control deslizante.
Comentarios
Especifica el intervalo de los valores del control deslizante al establecer los valores mínimo y máximo.
CMFCRibbonSlider::SetZoomButtons
Muestra u oculta botones de zoom.
void SetZoomButtons(BOOL bSet=TRUE);
Parámetros
[in]. bSet TRUE para mostrar los botones del zoom, para ocultarlos.
CMFCRibbonSlider::SetZoomIncrement
Establece el incremento de zoom del control deslizante.
void SetZoomIncrement(int nZoomIncrement);
Parámetros
nZoomIncrement
[in] Especifica el incremento de zoom del control deslizante.