Classe CMFCRibbonSlider
A classe CMFCRibbonSlider implementa um controle deslizante que você pode adicionar a uma barra de faixa de opções ou barra de status da faixa de opções. O controle deslizante da faixa de opções se assemelha aos controles deslizantes de zoom que aparecem nos aplicativos do Office 2007.
Sintaxe
class CMFCRibbonSlider : public CMFCRibbonBaseElement
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CMFCRibbonSlider::CMFCRibbonSlider | Constrói e inicializa um controle deslizante de faixa de opções. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CMFCRibbonSlider::GetPos | Retorna a posição atual do controle deslizante. |
| CMFCRibbonSlider::GetRangeMax | Retorna o valor máximo do controle deslizante. |
| CMFCRibbonSlider::GetRangeMin | Retorna o valor mínimo do controle deslizante. |
| CMFCRibbonSlider::GetRegularSize | Retorna o tamanho regular do elemento da faixa de opções. (Substitui CMFCRibbonBaseElement::GetRegularSize.) |
| CMFCRibbonSlider::GetZoomIncrement | Retorna o tamanho do incremento de zoom para o controle deslizante. |
| CMFCRibbonSlider::HasZoomButtons | Especifica se o controle deslizante tem botões de zoom. |
| CMFCRibbonSlider::OnDraw | Chamado pela estrutura para desenhar o elemento da faixa de opções. (Substitui CMFCRibbonBaseElement::OnDraw.) |
| CMFCRibbonSlider::SetPos | Define a posição atual do controle deslizante. |
| CMFCRibbonSlider::SetRange | Especifica o intervalo do controle deslizante definindo os valores mínimo e máximo. |
| CMFCRibbonSlider::SetZoomButtons | Mostra ou oculta os botões de zoom. |
| CMFCRibbonSlider::SetZoomIncrement | Define o tamanho do incremento de zoom para o controle deslizante. |
Comentários
Você pode usar o método SetRange para configurar o intervalo de incrementos de zoom para o controle deslizante. Você pode definir a posição atual do controle deslizante usando o método SetPos.
Você pode exibir botões de zoom circular no lado esquerdo e direito do controle deslizante usando o método SetZoomButtons. Por padrão, o controle deslizante é horizontal, o botão de zoom esquerdo exibe um sinal de subtração e o botão de zoom direito exibe um sinal de adição.
O método SetZoomIncrement define o incremento a ser adicionado ou subtraído da posição atual quando um usuário clica nos botões de zoom.
Exemplo
O exemplo a seguir demonstra como usar vários métodos na classe CMFCRibbonSlider para definir as propriedades do controle deslizante. O exemplo mostra como construir um objeto CMFCRibbonSlider, exibir botões de zoom, definir a posição atual do controle deslizante e definir o intervalo de valores para o controle 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
Requisitos
Cabeçalho: afxribbonslider.h
CMFCRibbonSlider::CMFCRibbonSlider
Construir um controle deslizante de faixa de opções.
CMFCRibbonSlider(
UINT nID,
int nWidth=100);
Parâmetros
Nid
[in] ID do controle deslizante.
[in]. nWidth Largura do controle deslizante em pixels.
Comentários
Constrói um controle deslizante de faixa de opções com nWidth pixels de largura na categoria de painel em que o controle deslizante é adicionado. Por padrão, o controle deslizante é horizontal.
CMFCRibbonSlider::GetPos
Retorna a posição atual do controle deslizante.
int GetPos() const;
Valor de retorno
A posição atual do controle deslizante, que é uma posição relativa ao início do controle deslizante.
CMFCRibbonSlider::GetRangeMax
Obtém o incremento máximo do controle deslizante que o controle deslizante pode percorrer no controle deslizante.
int GetRangeMax() const;
Valor de retorno
O incremento máximo do controle deslizante que o controle deslizante pode percorrer no controle deslizante.
CMFCRibbonSlider::GetRangeMin
Retorna o incremento mínimo que o controle deslizante pode percorrer no controle deslizante.
int GetRangeMin() const;
Valor de retorno
O incremento mínimo que o controle deslizante pode percorrer no controle deslizante.
CMFCRibbonSlider::GetRegularSize
Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.
virtual CSize GetRegularSize(CDC* pDC);
Parâmetros
[in] pDC
Valor de retorno
Comentários
CMFCRibbonSlider::GetZoomIncrement
Obtenha o incremento de zoom para o controle deslizante.
int GetZoomIncrement() const;
Valor de retorno
O incremento de zoom para o controle deslizante.
CMFCRibbonSlider::HasZoomButtons
Especifica se o controle deslizante tem botões de zoom.
BOOL HasZoomButtons() const;
Valor de retorno
TRUE se o controle deslizante tiver botões de zoom; caso contrário, FALSE.
CMFCRibbonSlider::OnDraw
Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.
virtual void OnDraw(CDC* pDC);
Parâmetros
[in] pDC
Comentários
CMFCRibbonSlider::SetPos
Defina a posição atual do controle deslizante.
void SetPos(
int nPos,
BOOL bRedraw=TRUE);
Parâmetros
nPos
[in] Especifica a posição a ser definida para o controle deslizante. A posição é relativa ao início do controle deslizante.
bRedraw
[in] Se TRUE, o controle deslizante será redesenhado.
CMFCRibbonSlider::SetRange
Defina o intervalo de valores para o controle deslizante.
void SetRange(
int nMin,
int nMax);
Parâmetros
nMin
[in] Especifica o valor mínimo do controle deslizante.
nMax
[in] Especifica o valor máximo do controle deslizante.
Comentários
Especifica o intervalo de valores para o controle deslizante definindo os valores mínimo e máximo.
CMFCRibbonSlider::SetZoomButtons
Exibir ou ocultar botões de zoom.
void SetZoomButtons(BOOL bSet=TRUE);
Parâmetros
[in]. bSet TRUE para exibir botões de zoom; FALSE para ocultá-los.
CMFCRibbonSlider::SetZoomIncrement
Defina o incremento de zoom para o controle deslizante.
void SetZoomIncrement(int nZoomIncrement);
Parâmetros
nZoomIncrement
[in] Especifica o incremento de zoom do controle deslizante.