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

CObject

CMFCRibbonBaseElement

CMFCRibbonSlider

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.

Consulte también

Gráfico de jerarquías
Clases
CMFCRibbonBaseElement (clase)