CMFCRibbonSlider クラス

CMFCRibbonSlider クラスは、リボン バーまたはリボン ステータス バーに追加できるスライダー コントロールを実装します。 リボン スライダー コントロールは、Office 2007 アプリケーションに表示されるズーム スライダーに似ています。

構文

class CMFCRibbonSlider : public CMFCRibbonBaseElement

メンバー

パブリック コンストラクター

名前 説明
CMFCRibbonSlider::CMFCRibbonSlider リボン スライダー コントロールを構築して初期化します。

パブリック メソッド

名前 説明
CMFCRibbonSlider::GetPos スライダー コントロールの現在位置を返します。
CMFCRibbonSlider::GetRangeMax スライダーの最大値を返します。
CMFCRibbonSlider::GetRangeMin スライダーの最小値を返します。
CMFCRibbonSlider::GetRegularSize リボン要素の標準サイズを返します。 ( をオーバーライドしますCMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonSlider::GetZoomIncrement スライダー コントロールのズーム増分のサイズを返します。
CMFCRibbonSlider::HasZoomButtons スライダーにズーム ボタンがあるかどうかを指定します。
CMFCRibbonSlider::OnDraw リボン要素を描画するために、フレームワークによって呼び出されます。 ( をオーバーライドしますCMFCRibbonBaseElement::OnDraw.)
CMFCRibbonSlider::SetPos スライダー コントロールの現在位置を設定します。
CMFCRibbonSlider::SetRange 最小値と最大値を設定して、スライダー コントロールの範囲を指定します。
CMFCRibbonSlider::SetZoomButtons ズーム ボタンを表示または非表示にします。
CMFCRibbonSlider::SetZoomIncrement スライダー コントロールのズーム増分のサイズを設定します。

解説

SetRangeメソッドを使用して、スライダーのズーム増分の範囲を構成できます。 スライダーの現在位置は、 SetPos メソッドを使用して設定できます。

SetZoomButtonsメソッドを使用すると、スライダー コントロールの左右に円形のズーム ボタンを表示できます。 既定では、スライダーは水平で、左のズーム ボタンにはマイナス記号が表示され、右のズーム ボタンにはプラス記号が表示されます。

SetZoomIncrementメソッドは、ユーザーがズーム ボタンをクリックしたときに現在の位置に加算または減算するインクリメントを定義します。

次の例では、 CMFCRibbonSlider クラスのさまざまなメソッドを使用してスライダーのプロパティを設定する方法を示します。 この例では、 CMFCRibbonSlider オブジェクトの構築、ズーム ボタンの表示、スライダー コントロールの現在位置の設定、スライダー コントロールの値の範囲の設定を行う方法を示します。

// 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);

継承階層

CObject

CMFCRibbonBaseElement

CMFCRibbonSlider

要件

Header: afxribbonslider.h

CMFCRibbonSlider::CMFCRibbonSlider

リボン スライダーを作成します。

CMFCRibbonSlider(
    UINT nID,
    int nWidth=100);

パラメーター

nID
[in]スライダー ID。

[in]. nWidth スライダーの幅 (ピクセル単位)。

解説

スライダーが追加されるパネル カテゴリの幅 nWidth ピクセルのリボン スライダーを構築します。 既定では、スライダーは水平です。

CMFCRibbonSlider::GetPos

スライダー コントロールの現在位置を返します。

int GetPos() const;

戻り値

スライダー コントロールの現在の位置。スライダーの先頭を基準とした位置です。

CMFCRibbonSlider::GetRangeMax

スライダー コントロールでスライダーが移動できるスライダーの最大増分値を取得します。

int GetRangeMax() const;

戻り値

スライダー コントロールでスライダーが移動できるスライダーの最大増分値。

CMFCRibbonSlider::GetRangeMin

スライダーコントロール上でスライダーが移動できる最小増分値を返します。

int GetRangeMin() const;

戻り値

スライダーがスライダー コントロール上を移動できる最小増分値。

CMFCRibbonSlider::GetRegularSize

詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。

virtual CSize GetRegularSize(CDC* pDC);

パラメーター

[入力] pDC

戻り値

解説

CMFCRibbonSlider::GetZoomIncrement

スライダー コントロールのズーム 増分を取得します。

int GetZoomIncrement() const;

戻り値

スライダー コントロールのズーム増分。

CMFCRibbonSlider::HasZoomButtons

スライダーにズーム ボタンがあるかどうかを指定します。

BOOL HasZoomButtons() const;

戻り値

スライダーにズーム ボタンがある場合は TRUE。それ以外の場合は FALSE。

CMFCRibbonSlider::OnDraw

詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。

virtual void OnDraw(CDC* pDC);

パラメーター

[入力] pDC

解説

CMFCRibbonSlider::SetPos

スライダー コントロールの現在位置を設定します。

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

パラメーター

nPos
[in]スライダーに設定する位置を指定します。 位置は、スライダーの先頭を基準にしています。

bRedraw
[in]TRUE の場合、スライダーが再描画されます。

CMFCRibbonSlider::SetRange

スライダー コントロールの値の範囲を設定します。

void SetRange(
    int nMin,
    int nMax);

パラメーター

nMin
[in]スライダー コントロールの最小値を指定します。

nMax
[in]スライダー コントロールの最大値を指定します。

解説

最小値と最大値を設定して、スライダー コントロールの値の範囲を指定します。

CMFCRibbonSlider::SetZoomButtons

ズーム ボタンを表示または非表示にします。

void SetZoomButtons(BOOL bSet=TRUE);

パラメーター

[in]. bSet ズーム ボタンを表示する場合は TRUE。非表示にする場合は FALSE。

CMFCRibbonSlider::SetZoomIncrement

スライダー コントロールのズーム増分を設定します。

void SetZoomIncrement(int nZoomIncrement);

パラメーター

nZoomIncrement
[in]スライダー コントロールのズーム 増分を指定します。

関連項目

階層図
クラス
CMFCRibbonBaseElement クラス