Freigeben über


CMFCRibbonSlider-Klasse

Die CMFCRibbonSlider Klasse implementiert ein Schieberegler-Steuerelement, das Sie einer Menübandleiste oder Menüband-Statusleiste hinzufügen können. Das Schieberegler-Steuerelement im Menüband ähnelt den Zoomschiebereglern, die in Office 2007-Anwendungen verwendet werden.

Syntax

class CMFCRibbonSlider : public CMFCRibbonBaseElement

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCRibbonSlider::CMFCRibbonSlider Erstellt und initialisiert ein Menüband-Schieberegler-Steuerelement.

Öffentliche Methoden

Name Beschreibung
CMFCRibbonSlider::GetPos Gibt die aktuelle Position des Schieberegler-Steuerelements zurück.
CMFCRibbonSlider::GetRangeMax Gibt den Maximalwert des Schiebereglers zurück.
CMFCRibbonSlider::GetRangeMin Gibt den Minimalwert des Schiebereglers zurück.
CMFCRibbonSlider::GetRegularSize Gibt die reguläre Größe des Menübandelements zurück. (Außerkraftsetzungen CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonSlider::GetZoomIncrement Gibt die Größe des Zoomschritts für das Schieberegler-Steuerelement zurück.
CMFCRibbonSlider::HasZoomButtons Gibt an, ob der Schieberegler Zoomschaltflächen enthält.
CMFCRibbonSlider::OnDraw Wird vom Framework aufgerufen, um das Menübandelement zu zeichnen. (Außerkraftsetzungen CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonSlider::SetPos Legt die aktuelle Position des Schieberegler-Steuerelements fest.
CMFCRibbonSlider::SetRange Gibt den Bereich des Schieberegler-Steuerelements an, indem sie die Mindest- und Höchstwerte festlegen.
CMFCRibbonSlider::SetZoomButtons Blendet die Zoomschaltflächen ein oder aus.
CMFCRibbonSlider::SetZoomIncrement Legt die Größe des Zoomschritts für das Schieberegler-Steuerelement fest.

Hinweise

Mit der SetRange Methode können Sie den Bereich der Zoomschritte für den Schieberegler konfigurieren. Mit der SetPos Methode können Sie die aktuelle Position des Schiebereglers festlegen.

Sie können kreisförmige Zoomschaltflächen auf der linken und rechten Seite des Schieberegler-Steuerelements mithilfe der SetZoomButtons Methode anzeigen. Standardmäßig ist der Schieberegler horizontal, die linke Zoomschaltfläche zeigt ein Minuszeichen an, und die rechte Zoomschaltfläche zeigt ein Pluszeichen an.

Die SetZoomIncrement Methode definiert das Inkrement, das der aktuellen Position hinzugefügt oder subtrahiert werden soll, wenn ein Benutzer auf die Zoomschaltflächen klickt.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie verschiedene Methoden in der CMFCRibbonSlider Klasse verwendet werden, um die Eigenschaften des Schiebereglers festzulegen. Das Beispiel zeigt, wie Sie ein CMFCRibbonSlider Objekt erstellen, Zoomschaltflächen anzeigen, die aktuelle Position des Schieberegler-Steuerelements festlegen und den Wertebereich für das Schieberegler-Steuerelement festlegen.

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

Vererbungshierarchie

CObject

CMFCRibbonBaseElement

CMFCRibbonSlider

Anforderungen

Kopfzeile: afxribbonslider.h

CMFCRibbonSlider::CMFCRibbonSlider

Erstellen Sie einen Menübandschieberegler.

CMFCRibbonSlider(
    UINT nID,
    int nWidth=100);

Parameter

Nid
[in] Schieberegler-ID.

[in] Breite des nWidth-Schiebereglers in Pixeln.

Hinweise

Erstellt einen Menübandschieberegler, der nWidth Pixel breit in der Bereichskategorie ist, in der der Schieberegler hinzugefügt wird. Standardmäßig ist der Schieberegler horizontal.

CMFCRibbonSlider::GetPos

Gibt die aktuelle Position des Schieberegler-Steuerelements zurück.

int GetPos() const;

Rückgabewert

Die aktuelle Position des Schieberegler-Steuerelements, bei dem es sich um eine Position relativ zum Anfang des Schiebereglers handelt.

CMFCRibbonSlider::GetRangeMax

Ruft die maximale Inkrementierung des Schiebereglers ab, den der Schieberegler auf dem Schieberegler-Steuerelement bewegen kann.

int GetRangeMax() const;

Rückgabewert

Die maximale Inkrementierung des Schiebereglers, den der Schieberegler auf dem Schieberegler-Steuerelement bewegen kann.

CMFCRibbonSlider::GetRangeMin

Gibt die minimale Inkrementierung zurück, die der Schieberegler auf dem Schieberegler-Steuerelement bewegen kann.

int GetRangeMin() const;

Rückgabewert

Die minimale Inkrementierung, die der Schieberegler auf dem Schieberegler-Steuerelement bewegen kann.

CMFCRibbonSlider::GetRegularSize

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

virtual CSize GetRegularSize(CDC* pDC);

Parameter

[in] pDC

Rückgabewert

Bemerkungen

CMFCRibbonSlider::GetZoomIncrement

Rufen Sie den Zoomschritt für das Schieberegler-Steuerelement ab.

int GetZoomIncrement() const;

Rückgabewert

Der Zoomschritt für das Schieberegler-Steuerelement.

CMFCRibbonSlider::HasZoomButtons

Gibt an, ob der Schieberegler Zoomschaltflächen enthält.

BOOL HasZoomButtons() const;

Rückgabewert

TRUE, wenn der Schieberegler Zoomschaltflächen aufweist; Andernfalls FALSE.

CMFCRibbonSlider::OnDraw

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

virtual void OnDraw(CDC* pDC);

Parameter

[in] pDC

Hinweise

CMFCRibbonSlider::SetPos

Legen Sie die aktuelle Position des Schieberegler-Steuerelements fest.

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

Parameter

nPos
[in] Gibt die position an, die für den Schieberegler festgelegt werden soll. Die Position ist relativ zum Anfang des Schiebereglers.

bRedraw
[in] Wenn TRUE, wird der Schieberegler neu gezeichnet.

CMFCRibbonSlider::SetRange

Legen Sie den Wertebereich für das Schieberegler-Steuerelement fest.

void SetRange(
    int nMin,
    int nMax);

Parameter

nMin
[in] Gibt den Minimalwert des Schieberegler-Steuerelements an.

nMax
[in] Gibt den Maximalwert des Schieberegler-Steuerelements an.

Hinweise

Gibt den Wertebereich für das Schieberegler-Steuerelement an, indem sie die Mindest- und Höchstwerte festlegen.

CMFCRibbonSlider::SetZoomButtons

Zoomschaltflächen ein- oder ausblenden.

void SetZoomButtons(BOOL bSet=TRUE);

Parameter

[in] bSet TRUE zum Anzeigen von Zoomschaltflächen; FALSE, um sie auszublenden.

CMFCRibbonSlider::SetZoomIncrement

Legen Sie den Zoomschritt für das Schieberegler-Steuerelement fest.

void SetZoomIncrement(int nZoomIncrement);

Parameter

nZoomIncrement
[in] Gibt den Zoomschritt des Schieberegler-Steuerelements an.

Siehe auch

Hierarchiediagramm
Klassen
CMFCRibbonBaseElement-Klasse