Delen via

CSpinButtonCtrl-klasse

  • Artikel

Biedt de functionaliteit van het besturingselement algemene kringknop van Windows.

Syntaxis

class CSpinButtonCtrl : public CWnd

Leden

Openbare constructors

Naam Beschrijving
CSpinButtonCtrl::CSpinButtonCtrl Maakt een CSpinButtonCtrl-object.

Openbare methoden

Naam Beschrijving
CSpinButtonCtrl:: maken Hiermee maakt u een kringknop en koppelt u het aan een CSpinButtonCtrl-object.
CSpinButtonCtrl::CreateEx- Hiermee maakt u een kringknop besturingselement met de opgegeven uitgebreide Stijlen van Windows en koppelt u het aan een CSpinButtonCtrl object.
CSpinButtonCtrl::GetAccel- Hiermee haalt u informatie over versnelling op voor een kringknopbesturing.
CSpinButtonCtrl::GetBase Hiermee haalt u de huidige basis voor een kringknopbesturing op.
CSpinButtonCtrl::GetBuddy- Hiermee wordt een aanwijzer naar het huidige buddyvenster opgehaald.
CSpinButtonCtrl::GetPos Hiermee haalt u de huidige positie van een kringknopbesturing op.
CSpinButtonCtrl::GetRange Haalt de boven- en ondergrenswaarden (bereik) op voor een kringknopbesturing.
CSpinButtonCtrl::SetAccel Hiermee stelt u de versnelling in voor een kringknopbesturing.
CSpinButtonCtrl::SetBase Hiermee stelt u de basis in voor een kringknopbesturing.
CSpinButtonCtrl::SetBuddy Hiermee stelt u het buddyvenster in voor een draaiknopbesturing.
CSpinButtonCtrl::SetPos Hiermee stelt u de huidige positie voor het besturingselement in.
CSpinButtonCtrl::SetRange Hiermee stelt u de boven- en ondergrens (bereik) in voor een kringknopbesturing.

Opmerkingen

Een kringknopbesturingselement (ook wel een besturingselement omhoog genoemd) is een paar pijlknoppen waarop de gebruiker kan klikken om een waarde te verhogen of te verlagen, zoals een schuifpositie of een getal dat wordt weergegeven in een metgezel besturingselement. De waarde die is gekoppeld aan een draaiknop wordt de huidige positie genoemd. Een kringknopbesturing wordt meestal gebruikt met een bijgezel besturingselement, een 'maatjevenster' genoemd.

Dit besturingselement (en daarom de CSpinButtonCtrl klasse) is alleen beschikbaar voor programma's die worden uitgevoerd onder Windows 95/98 en Windows NT versie 3.51 en hoger.

Voor de gebruiker ziet een kringknop en het bijbehorende maatvenster er vaak uit als één besturingselement. U kunt opgeven dat een draaiknop besturingselement automatisch naast het buddyvenster wordt geplaatst en dat het automatisch het bijschrift van het buddyvenster instelt op de huidige positie. U kunt een kringknopbesturingselement gebruiken met een besturingselement bewerken om de gebruiker te vragen om numerieke invoer.

Als u op de pijl-omhoog klikt, wordt de huidige positie naar het maximum verplaatst en wordt de huidige positie naar het minimum verplaatst door op de pijl-omlaag te klikken. Standaard is het minimum 100 en is het maximum 0. Wanneer de minimuminstelling groter is dan de maximuminstelling (bijvoorbeeld wanneer de standaardinstellingen worden gebruikt), wordt de positiewaarde verlaagd door op de pijl-omhoog te klikken en op de pijl-omlaag te klikken.

Een kringknopbesturing zonder een buddyvenster werkt als een soort vereenvoudigde schuifbalk. In een tab besturingselement wordt bijvoorbeeld soms een besturingselement voor een draaiknop weergegeven om de gebruiker in staat te stellen om extra tabbladen in beeld te schuiven.

Zie Controls and Using CSpinButtonCtrlvoor meer informatie over het gebruik van CSpinButtonCtrl.

Overnamehiërarchie

CObject-

CCmdTarget-

CSpinButtonCtrl

Eisen

koptekst: afxcmn.h

CSpinButtonCtrl::Maken

Hiermee maakt u een kringknop en koppelt u het aan een CSpinButtonCtrl-object.

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

Parameters

dwStyle-
Hiermee geeft u de stijl van het kringknop besturingselement. Pas een combinatie van kringknopbesturingsstijlen toe op het besturingselement. Deze stijlen worden beschreven in Up-Down Besturingsstijlen in de Windows SDK.

rect
Hiermee geeft u de grootte en positie van het kringknop besturingselement. Het kan een CRect--object of een RECT--structuur zijn

pParentWnd
Een aanwijzer naar het bovenliggende venster van het kringknop besturingselement, meestal een CDialog. Deze mag niet NULL zijn.

nID-
Hiermee geeft u de id van het kringknop besturingselement.

Retourwaarde

Niet-nul als initialisatie is geslaagd; anders 0.

Opmerkingen

U maakt een CSpinButtonCtrl object in twee stappen eerst, roept de constructor aan en roept vervolgens Createaan, waarmee het besturingselement kringknop wordt gemaakt en aan het CSpinButtonCtrl-object wordt gekoppeld.

Als u een kringknop besturingselement met uitgebreide vensterstijlen wilt maken, roept u CSpinButtonCtrl::CreateEx aan in plaats van Create.

CSpinButtonCtrl::CreateEx

Hiermee maakt u een besturingselement (een onderliggend venster) en koppelt u dit aan het CSpinButtonCtrl-object.

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

Parameters

dwExStyle-
Hiermee geeft u de uitgebreide stijl van het besturingselement dat wordt gemaakt. Zie de parameter dwExStyle voor CreateWindowEx- in de Windows SDK voor een lijst met uitgebreide vensterstijlen.

dwStyle-
Hiermee geeft u de stijl van het kringknop besturingselement. Pas een combinatie van kringknopbesturingsstijlen toe op het besturingselement. Deze stijlen worden beschreven in Up-Down Besturingsstijlen in de Windows SDK.

rect
Een verwijzing naar een RECT structuur die de grootte en positie van het venster beschrijft dat moet worden gemaakt, in clientcoördinaten van pParentWnd.

pParentWnd
Een aanwijzer naar het venster dat het bovenliggende besturingselement is.

nID-
De id van het onderliggende venster van het besturingselement.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Gebruik CreateEx in plaats van maken om uitgebreide Windows-stijlen toe te passen, die zijn opgegeven door het WS_EX_ van de uitgebreide stijl van Windows.

CSpinButtonCtrl::CSpinButtonCtrl

Maakt een CSpinButtonCtrl-object.

CSpinButtonCtrl();

CSpinButtonCtrl::GetAccel

Hiermee haalt u informatie over versnelling op voor een kringknopbesturing.

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

Parameters

nAccel-
Aantal elementen in de matrix die is opgegeven door pAccel-.

pAccel-
Wijs een matrix aan van UDACCEL structuren die versnellingsinformatie ontvangen.

Retourwaarde

Aantal opgehaalde acceleratorstructuren.

CSpinButtonCtrl::GetBase

Hiermee haalt u de huidige basis voor een kringknopbesturing op.

UINT GetBase() const;

Retourwaarde

De huidige basiswaarde.

CSpinButtonCtrl::GetBuddy

Hiermee wordt een aanwijzer naar het huidige buddyvenster opgehaald.

CWnd* GetBuddy() const;

Retourwaarde

Een aanwijzer naar het huidige vriendvenster.

CSpinButtonCtrl::GetPos

Hiermee haalt u de huidige positie van een kringknopbesturing op.

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

Parameters

lpbError-
Een aanwijzer naar een Booleaanse waarde die is ingesteld op nul als de waarde is opgehaald of niet-nul als er een fout optreedt. Als deze parameter is ingesteld op NULL, worden er geen fouten gerapporteerd.

Retourwaarde

De eerste versie retourneert de 16-bits huidige positie in het woord met lage volgorde. Het woord in hoge volgorde is nietzero als er een fout is opgetreden.

De tweede versie retourneert de 32-bits positie.

Opmerkingen

Wanneer de geretourneerde waarde wordt verwerkt, wordt de huidige positie van het besturingselement bijgewerkt op basis van het bijschrift van het buddyvenster. Het besturingselement retourneert een fout als er geen maatjevenster is of als het bijschrift een ongeldige of buitenbereikwaarde aangeeft.

CSpinButtonCtrl::GetRange

Haalt de boven- en ondergrenswaarden (bereik) op voor een kringknopbesturing.

DWORD GetRange() const;

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

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

Parameters

lagere
Verwijzing naar een geheel getal dat de ondergrens voor het besturingselement ontvangt.

bovenste
Verwijzing naar een geheel getal dat de bovengrens voor het besturingselement ontvangt.

Retourwaarde

De eerste versie retourneert een 32-bits waarde die de boven- en ondergrens bevat. Het woord met een lage volgorde is de bovengrens voor het besturingselement en het woord in hoge volgorde is de ondergrens.

Opmerkingen

De lidfunctie GetRange32 haalt het bereik van het kringknopbesturingselement op als een 32-bits geheel getal.

CSpinButtonCtrl::SetAccel

Hiermee stelt u de versnelling in voor een kringknopbesturing.

BOOL SetAccel(
    int nAccel,
    UDACCEL* pAccel);

Parameters

nAccel-
Aantal UDACCEL structuren die zijn opgegeven door pAccel-.

pAccel-
Wijs een matrix van UDACCEL-structuren aan, die informatie over versnelling bevatten. Elementen moeten in oplopende volgorde worden gesorteerd op basis van het nSec lid.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

CSpinButtonCtrl::SetBase

Hiermee stelt u de basis in voor een kringknopbesturing.

int SetBase(int nBase);

Parameters

nBase-
Nieuwe basiswaarde voor het besturingselement. Het kan 10 zijn voor decimaal of 16 voor hexadecimaal.

Retourwaarde

De vorige basiswaarde als deze is geslaagd of nul als er een ongeldige basis is opgegeven.

Opmerkingen

De basiswaarde bepaalt of het maatjevenster getallen in decimale of hexadecimale cijfers weergeeft. Hexadecimale getallen zijn altijd niet ondertekend; decimale getallen worden ondertekend.

CSpinButtonCtrl::SetBuddy

Hiermee stelt u het buddyvenster in voor een draaiknopbesturing.

CWnd* SetBuddy(CWnd* pWndBuddy);

Parameters

pWndBuddy-
Wijs het nieuwe vriendvenster aan.

Retourwaarde

Een aanwijzer naar het vorige buddyvenster.

Opmerkingen

Een kringveldbesturingselement is bijna altijd gekoppeld aan een ander venster, zoals een besturingselement bewerken, waarmee bepaalde inhoud wordt weergegeven. Dit andere venster wordt de 'buddy' van het spin-besturingselement genoemd.

CSpinButtonCtrl::SetPos

Hiermee stelt u de huidige positie voor een kringknopbesturing in.

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

Parameters


Nieuwe positie voor het besturingselement. Deze waarde moet zich in het bereik bevindt dat is opgegeven door de boven- en ondergrenzen voor het besturingselement.

Retourwaarde

De vorige positie (16-bits precisie voor SetPos, 32-bits precisie voor SetPos32).

Opmerkingen

SetPos32 stelt de 32-bits positie in.

CSpinButtonCtrl::SetRange

Hiermee stelt u de boven- en ondergrens (bereik) in voor een kringknopbesturing.

void SetRange(
    short nLower,
    short nUpper);

void SetRange32(
    int nLower,
    int nUpper);

Parameters

nLower en nUpper
Boven- en ondergrens voor het besturingselement. Voor SetRangemag geen van beide limieten groter zijn dan UD_MAXVAL of kleiner dan UD_MINVAL; Bovendien kan het verschil tussen de twee limieten niet groter zijn dan UD_MAXVAL. SetRange32 geen beperkingen opleggen aan de limieten; alle gehele getallen gebruiken.

Opmerkingen

De lidfunctie SetRange32 stelt het 32-bits bereik in voor het kringknopbesturingselement.

Notitie

Het standaardbereik voor de draaiknop heeft het maximum ingesteld op nul (0) en het minimum ingesteld op 100. Omdat de maximumwaarde kleiner is dan de minimumwaarde, wordt de positie verlaagd door op de pijl-omhoog te klikken en op de pijl-omlaag te klikken. Gebruik CSpinButtonCtrl::SetRange om deze waarden aan te passen.

Zie ook

MFC-voorbeeld CMNCTRL2
CWnd Class
Hiërarchiegrafiek
CSliderCtrl-klasse