Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
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.