CSpinButtonCtrl-Klasse

Stellt die Funktionalität des allgemeinen Windows-Drehfeld-Steuerelements bereit.

Syntax

class CSpinButtonCtrl : public CWnd

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Hinweise

Ein "Drehfeld-Steuerelement" (auch als Nach-unten-Steuerelement bezeichnet) ist ein Paar von Pfeilschaltflächen, auf das der Benutzer klicken kann, um einen Wert zu erhöhen oder zu erhöhen, z. B. eine Bildlaufposition oder eine Zahl, die in einem Begleitsteuerelement angezeigt wird. Der wert, der einem Drehschaltflächen-Steuerelement zugeordnet ist, wird als aktuelle Position bezeichnet. Ein Drehfeld-Steuerelement wird am häufigsten mit einem Begleitsteuerelement verwendet, das als "Kumpelfenster" bezeichnet wird.

Dieses Steuerelement (und daher die Klasse) ist nur für Programme verfügbar, die CSpinButtonCtrl unter Windows 95/98 und Windows NT, Version 3.51 und höher ausgeführt werden.

Für den Benutzer sieht ein Drehfeld-Steuerelement und sein Kumpelfenster oft wie ein einzelnes Steuerelement aus. Sie können angeben, dass sich ein Drehfeld-Steuerelement automatisch neben seinem Kumpelfenster positioniert und die Beschriftung des Kumpelfensters automatisch auf seine aktuelle Position festgelegt wird. Sie können ein Drehfeld-Steuerelement mit einem Bearbeitungssteuerelement verwenden, um den Benutzer zur Eingabe numerischer Eingaben aufzufordern.

Wenn Sie auf den Pfeil nach oben klicken, wird die aktuelle Position in Richtung des Maximums verschoben, und durch Klicken auf den Abwärtspfeil wird die aktuelle Position auf das Minimum verschoben. Standardmäßig beträgt der Mindestwert 100 und der Maximalwert 0. Jedes Mal, wenn die Mindesteinstellung größer als die maximale Einstellung ist (z. B. wenn die Standardeinstellungen verwendet werden), wird durch Klicken auf den Nach-oben-Pfeil der Positionswert verringert und durch Klicken auf den Abwärtspfeil erhöht.

Ein Drehfeld-Steuerelement ohne ein Kumpelfenster funktioniert als eine Art vereinfachter Bildlaufleiste. Beispielsweise zeigt ein Registerkartensteuerelement manchmal ein Drehfeld-Steuerelement an, damit der Benutzer zusätzliche Registerkarten in die Ansicht scrollen kann.

Weitere Informationen zur Verwendung CSpinButtonCtrlfinden Sie unter "Steuerelemente und Verwenden von CSpinButtonCtrl".

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CSpinButtonCtrl

Anforderungen

Header: afxcmn.h

CSpinButtonCtrl::Create

Erstellt ein Drehfeld-Steuerelement und fügt es an ein CSpinButtonCtrl Objekt an.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Gibt die Formatvorlage des Drehfeld-Steuerelements an. Wenden Sie eine beliebige Kombination von Steuerelementstilen für Drehschaltflächen auf das Steuerelement an. Diese Stile werden im Windows SDK in Den Stilen für die Nach-unten-Steuerung beschrieben.

rect
Gibt die Größe und Position des Drehfeld-Steuerelements an. Dabei kann es sich um ein CRect-Objekt oder eine RECT-Struktur handeln.

pParentWnd
Ein Zeiger auf das übergeordnete Fenster des Drehfeld-Steuerelements, in der Regel ein CDialog. Er darf nicht NULL sein.

Nid
Gibt die ID des Drehfeld-Steuerelements an.

Rückgabewert

Nonzero, wenn die Initialisierung erfolgreich war; andernfalls 0.

Hinweise

Sie erstellen ein CSpinButtonCtrl Objekt in zwei Schritten zuerst, rufen den Konstruktor auf, und rufen sie dann auf Create, wodurch das Drehfeld-Steuerelement erstellt und an das CSpinButtonCtrl Objekt angefügt wird.

Rufen Sie zum Erstellen eines Drehfeld-Steuerelements mit erweiterten Fensterformaten CSpinButtonCtrl::CreateEx anstelle von Create.

CSpinButtonCtrl::CreateEx

Erstellt ein Steuerelement (ein untergeordnetes Fenster) und ordnet es dem Objekt zu CSpinButtonCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Gibt die erweiterte Formatvorlage des zu erstellenden Steuerelements an. Eine Liste der erweiterten Fensterstile finden Sie im DwExStyle-Parameter für CreateWindowEx im Windows SDK.

dwStyle
Gibt die Formatvorlage des Drehfeld-Steuerelements an. Wenden Sie eine beliebige Kombination von Steuerelementstilen für Drehschaltflächen auf das Steuerelement an. Diese Stile werden im Windows SDK in Den Stilen für die Nach-unten-Steuerung beschrieben.

rect
Ein Verweis auf eine RECT-Struktur , die die Größe und Position des zu erstellenden Fensters in Clientkoordinaten von pParentWnd beschreibt.

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Steuerelement ist.

Nid
Die Untergeordnete Fenster-ID des Steuerelements.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Verwenden Sie CreateEx anstelle von "Erstellen ", um erweiterte Windows-Formatvorlagen anzuwenden, die durch die erweiterte Windows-Formatvorlage WS_EX_ angegeben werden.

CSpinButtonCtrl::CSpinButtonCtrl

Erstellt ein CSpinButtonCtrl-Objekt.

CSpinButtonCtrl();

CSpinButtonCtrl::GetAccel

Ruft Beschleunigungsinformationen für ein Drehfeld-Steuerelement ab.

UINT GetAccel(
    int nAccel,
    UDACCEL* pAccel) const;

Parameter

nAccel
Anzahl der Elemente in dem durch pAccel angegebenen Array.

pAccel
Zeigen Sie auf ein Array von UDACCEL-Strukturen , die Beschleunigungsinformationen empfangen.

Rückgabewert

Anzahl der abgerufenen Zugriffstastenstrukturen.

CSpinButtonCtrl::GetBase

Ruft die aktuelle Basis für ein Drehfeld-Steuerelement ab.

UINT GetBase() const;

Rückgabewert

Der aktuelle Basiswert.

CSpinButtonCtrl::GetBuddy

Ruft einen Zeiger auf das aktuelle Kontaktfenster ab.

CWnd* GetBuddy() const;

Rückgabewert

Ein Zeiger auf das aktuelle Kumpelfenster.

CSpinButtonCtrl::GetPos

Ruft die aktuelle Position eines Drehfeld-Steuerelements ab.

int GetPos() const;  int GetPos32(LPBOOL lpbError = NULL) const;

Parameter

lpbError
Ein Zeiger auf einen booleschen Wert, der auf Null festgelegt ist, wenn der Wert erfolgreich abgerufen oder nicht null abgerufen wird, wenn ein Fehler auftritt. Wenn dieser Parameter auf NULL festgelegt ist, werden keine Fehler gemeldet.

Rückgabewert

Die erste Version gibt die aktuelle Position der 16-Bit-Version im Wort mit niedriger Reihenfolge zurück. Das Wort "Hochreihenfolge" ist "nonzero", wenn ein Fehler aufgetreten ist.

Die zweite Version gibt die 32-Bit-Position zurück.

Hinweise

Wenn der zurückgegebene Wert verarbeitet wird, aktualisiert das Steuerelement seine aktuelle Position basierend auf der Beschriftung des Kumpelfensters. Das Steuerelement gibt einen Fehler zurück, wenn kein Kumpelfenster vorhanden ist oder wenn die Beschriftung einen ungültigen oder nicht gültigen Wert angibt.

CSpinButtonCtrl::GetRange

Ruft die oberen und unteren Grenzwerte (Bereich) für ein Drehfeld-Steuerelement ab.

DWORD GetRange() const;

void GetRange(
    int& lower,
    int& upper) const;

void GetRange32(
    int& lower,
    int &upper) const;

Parameter

lower
Verweisen auf eine ganze Zahl, die den unteren Grenzwert für das Steuerelement erhält.

upper
Bezug auf eine ganze Zahl, die die obere Grenze für das Steuerelement erhält.

Rückgabewert

Die erste Version gibt einen 32-Bit-Wert zurück, der die oberen und unteren Grenzwerte enthält. Das Wort mit niedriger Reihenfolge ist die obere Grenze für das Steuerelement, und das Wort mit hoher Reihenfolge ist die untere Grenze.

Hinweise

Die Memberfunktion GetRange32 ruft den Bereich des Drehfeld-Steuerelements als 32-Bit-Ganzzahl ab.

CSpinButtonCtrl::SetAccel

Legt die Beschleunigung für ein Drehfeld-Steuerelement fest.

BOOL SetAccel(
    int nAccel,
    UDACCEL* pAccel);

Parameter

nAccel
Anzahl der von pAccel angegebenen UDACCEL-Strukturen.

pAccel
Zeiger auf ein Array von UDACCEL-Strukturen, die Beschleunigungsinformationen enthalten. Elemente sollten basierend auf dem nSec Element in aufsteigender Reihenfolge sortiert werden.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

CSpinButtonCtrl::SetBase

Legt die Basis für ein Drehfeld-Steuerelement fest.

int SetBase(int nBase);

Parameter

nBase
Neuer Basiswert für das Steuerelement. Es kann 10 für dezimal oder 16 für hexadezimal sein.

Rückgabewert

Der vorherige Basiswert bei erfolgreicher Ausführung oder Null, wenn eine ungültige Basis angegeben wird.

Hinweise

Der Basiswert bestimmt, ob im Kumpelfenster Zahlen in Dezimal- oder Hexadezimalziffern angezeigt werden. Hexadezimalzahlen sind immer nicht signiert; Dezimalzahlen werden signiert.

CSpinButtonCtrl::SetBuddy

Legt das Kumpelfenster für ein Drehfeld-Steuerelement fest.

CWnd* SetBuddy(CWnd* pWndBuddy);

Parameter

pWndBuddy
Zeigen Sie auf das neue Kumpelfenster.

Rückgabewert

Ein Zeiger auf das vorherige Kumpelfenster.

Hinweise

Ein Drehsteuerelement ist fast immer einem anderen Fenster zugeordnet, z. B. einem Bearbeitungssteuerelement, das einige Inhalte anzeigt. Dieses andere Fenster wird als "Kumpel" des Drehsteuerelements bezeichnet.

CSpinButtonCtrl::SetPos

Legt die aktuelle Position für ein Drehfeld-Steuerelement fest.

int SetPos(int nPos);
int SetPos32(int nPos);

Parameter

nPos
Neue Position für das Steuerelement. Dieser Wert muss sich im Bereich befinden, der durch die oberen und unteren Grenzwerte für das Steuerelement angegeben wird.

Rückgabewert

Die vorherige Position (16-Bit-Genauigkeit für SetPos, 32-Bit-Genauigkeit für SetPos32).

Hinweise

SetPos32 legt die 32-Bit-Position fest.

CSpinButtonCtrl::SetRange

Legt die oberen und unteren Grenzwerte (Bereich) für ein Drehfeld-Steuerelement fest.

void SetRange(
    short nLower,
    short nUpper);

void SetRange32(
    int nLower,
    int nUpper);

Parameter

nLower und nUpper
Obere und untere Grenzwerte für das Steuerelement. Bei SetRangebeiden Grenzwerten kann keine Grenze größer als UD_MAXVAL oder kleiner als UD_MINVAL sein. Darüber hinaus kann der Unterschied zwischen den beiden Grenzwerten nicht UD_MAXVAL überschreiten. SetRange32 legt keine Einschränkungen für die Grenzen fest; verwenden Sie alle ganzzahligen Zahlen.

Hinweise

Die Memberfunktion SetRange32 legt den 32-Bit-Bereich für das Drehfeld-Steuerelement fest.

Siehe auch

MFC-Beispiel-CMNCTRL2
CWnd-Klasse
Hierarchiediagramm
CSliderCtrl-Klasse