Partilhar via


Classe CMFCRibbonSlider

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

A CMFCRibbonSlider classe implementa um controlo deslizante que podes adicionar a uma barra de fita ou de estado de fita. O controlo deslizante de fita assemelha-se aos deslizes de zoom que aparecem nas aplicações do Office 2007.

Sintaxe

class CMFCRibbonSlider : public CMFCRibbonBaseElement

Membros

Construtores Públicos

Nome Description
CMFCRibbonSlider::CMFCRibbonSlider Constrói e inicializa um controlo deslizante de fita.

Métodos Públicos

Nome Description
CMFCRibbonSlider::GetPos Devolve a posição atual do controlo deslizante.
CMFCRibbonSlider::GetRangeMax Devolve o valor máximo do slider.
CMFCRibbonSlider::GetRangeMin Devolve o valor mínimo do slider.
CMFCRibbonSlider::GetRegularSize Devolve o tamanho normal do elemento fita. (Sobrepõe CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonSlider::GetZoomIncrement Devolve o tamanho do incremento de zoom para o controlo deslizante.
CMFCRibbonSlider::HasZoomButtons Especifica se o slider tem botões de zoom.
CMFCRibbonSlider::OnDraw Chamado pelo framework para desenhar o elemento fita. (Sobrepõe o CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonSlider::SetPos Define a posição atual do controlo deslizante.
CMFCRibbonSlider::SetRange Especifica o alcance do controlo deslizante definindo os valores mínimo e máximo.
CMFCRibbonSlider::SetZoomButtons Mostra ou esconde os botões de zoom.
CMFCRibbonSlider::SetZoomIncrement Define o tamanho do incremento de zoom para o controlo deslizante.

Observações

Podes usar o SetRange método para configurar o intervalo de incrementos de zoom para o slider. Podes definir a posição atual do slider usando o SetPos método.

Podes mostrar botões circulares de zoom no lado esquerdo e direito do controlo deslizante usando este SetZoomButtons método. Por defeito, o controlo deslizante é horizontal, o botão de zoom esquerdo mostra um sinal menos e o botão direito de zoom mostra um sinal de mais.

O SetZoomIncrement método define o incremento a adicionar ou subtrair da posição atual quando o utilizador clica nos botões de zoom.

Example

O exemplo seguinte demonstra como usar vários métodos na CMFCRibbonSlider classe para definir as propriedades do slider. O exemplo mostra como construir um CMFCRibbonSlider objeto, mostrar botões de zoom, definir a posição atual do controlo deslizante e definir o intervalo de valores para o controlo 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);

Hierarquia de herança

CObject

CMFCRibbonBaseElement

CMFCRibbonSlider

Requerimentos

Cabeçalho: afxribbonslider.h

CMFCRibbonSlider::CMFCRibbonSlider

Constrói um deslizador de fita.

CMFCRibbonSlider(
    UINT nID,
    int nWidth=100);

Parâmetros

nID
[dentro] ID deslizante.

[em]. nLargura Largura do deslizador em pixels.

Observações

Constrói um deslizador de fita com nLargura de pixels na categoria do painel onde o deslizador é adicionado. Por defeito, o slider é horizontal.

CMFCRibbonSlider::GetPos

Devolve a posição atual do controlo deslizante.

int GetPos() const;

Valor de retorno

A posição atual do controlo deslizante, que é uma posição relativa ao início do controlo deslizante.

CMFCRibbonSlider::GetRangeMax

Obtém o incremento máximo do slider que o slider pode percorrer no controlo do slider.

int GetRangeMax() const;

Valor de retorno

O incremento máximo do slider que o slider pode percorrer no controlo do slider.

CMFCRibbonSlider::GetRangeMin

Devolve o incremento mínimo que o slider pode percorrer no controlo do slider.

int GetRangeMin() const;

Valor de retorno

O incremento mínimo que o slider pode percorrer no controlo do slider.

CMFCRibbonSlider::GetRegularSize

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

virtual CSize GetRegularSize(CDC* pDC);

Parâmetros

[dentro] pDC

Valor de retorno

Observações

CMFCRibbonSlider::GetZoomIncrement

Obtenha o incremento de zoom para o controlo do slider.

int GetZoomIncrement() const;

Valor de retorno

O incremento de zoom para o controlo deslizante.

CMFCRibbonSlider::HasZoomButtons

Especifica se o slider tem botões de zoom.

BOOL HasZoomButtons() const;

Valor de retorno

TRUE se o slider tiver botões de zoom; FALSO, caso contrário.

CMFCRibbonSlider::OnDraw

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

virtual void OnDraw(CDC* pDC);

Parâmetros

[dentro] pDC

Observações

CMFCRibbonSlider::SetPos

Defina a posição atual do controlo deslizante.

void SetPos(
    int nPos,
    BOOL bRedraw=TRUE);

Parâmetros

nPos
[dentro] Especifica a posição a definir para o slider. A posição é relativa ao início do slider.

bRedraw
[dentro] Se TRUE, o deslizador será redesenhado.

CMFCRibbonSlider::SetRange

Defina o intervalo de valores para o controlo deslizante.

void SetRange(
    int nMin,
    int nMax);

Parâmetros

nMin
[dentro] Especifica o valor mínimo do controlo deslizante.

nMax
[dentro] Especifica o valor máximo do controlo deslizante.

Observações

Especifica o intervalo de valores para o controlo deslizante definindo os valores mínimo e máximo.

CMFCRibbonSlider::SetZoomButtons

Mostrar ou esconder botões de zoom.

void SetZoomButtons(BOOL bSet=TRUE);

Parâmetros

[em]. bSet TRUE para exibir botões de zoom; FALSE para os esconder.

CMFCRibbonSlider::SetZoomIncrement

Define o incremento de zoom para o controlo deslizante.

void SetZoomIncrement(int nZoomIncrement);

Parâmetros

nZoomIncrement
[dentro] Especifica o incremento de zoom do controlo deslizante.

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCRibbonBaseElement