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
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.