CSpinButtonCtrl osztály

A Windows általános pörgetési gomb vezérlőjének funkcióit biztosítja.

Szintaxis

class CSpinButtonCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Leírás
CSpinButtonCtrl::CSpinButtonCtrl	Egy CSpinButtonCtrl objektumot hoz létre.

Nyilvános metódusok

Név	Leírás
CSpinButtonCtrl::Create	Létrehoz egy pörgetési gomb vezérlőt, és csatolja egy CSpinButtonCtrl objektumhoz.
CSpinButtonCtrl::CreateEx	Létrehoz egy spin gomb vezérlőelemet a megadott Bővített Windows-stílusokkal, és csatolja egy CSpinButtonCtrl objektumhoz.
CSpinButtonCtrl::GetAccel	Lekéri a gyorsítási információkat a spin gomb vezérlőjéhez.
CSpinButtonCtrl::GetBase	Lekéri a spin gomb vezérlőjének aktuális alapjait.
CSpinButtonCtrl::GetBuddy	Az aktuális haverablakra mutató mutatót kér le.
CSpinButtonCtrl::GetPos	Lekéri a spin gomb vezérlőjének aktuális pozícióját.
CSpinButtonCtrl::GetRange	Lekéri a spin gomb vezérlőelem felső és alsó korlátait (tartományát).
CSpinButtonCtrl::SetAccel	Beállítja a pörgetési gomb vezérlőjének gyorsulását.
CSpinButtonCtrl::SetBase	Beállítja a spin gomb vezérlőjének alapját.
CSpinButtonCtrl::SetBuddy	Beállítja a pajtásablakot a spin gomb vezérlőjéhez.
CSpinButtonCtrl::SetPos	Beállítja a vezérlő aktuális pozícióját.
CSpinButtonCtrl::SetRange	A spin gomb vezérlőelem felső és alsó korlátját (tartományát) állítja be.

Megjegyzések

A "pörgetési gomb vezérlőelem" (más néven felfelé mutató vezérlőelem) olyan nyílgombok párja, amelyekre a felhasználó rákattinthat egy érték növeléséhez vagy csökkenéséhez, például egy görgetési pozícióhoz vagy egy kísérő vezérlőelemben megjelenített számhoz. A pörgetési gomb vezérlőelemhez társított értéket az aktuális pozíciónak nevezzük. A pörgetési gomb vezérlőt leggyakrabban társvezérlővel, úgynevezett "pajtásablakkal" használják.

Ez a vezérlő (és ezért a CSpinButtonCtrl osztály) csak a Windows 95/98 és a Windows NT 3.51-es és újabb verzióiban futó programokhoz érhető el.

A felhasználó számára a spin gomb vezérlője és a haver ablaka gyakran úgy néz ki, mint egy vezérlő. Megadhatja, hogy a pörgetés gomb vezérlőelem automatikusan elhelyezze magát a haver ablaka mellett, és hogy automatikusan állítsa a pajtásablak feliratát az aktuális helyzetére. A pörgetés gombvezérlővel szerkesztési vezérlővel numerikus bemenetet kérhet a felhasználótól.

A felfelé mutató nyílra kattintva az aktuális pozíció a maximális értékre kerül, a lefelé mutató nyílra kattintva pedig az aktuális pozíció a minimum felé kerül. Alapértelmezés szerint a minimum 100, a maximum pedig 0. Ha a minimális beállítás nagyobb a maximális beállításnál (például az alapértelmezett beállítások használatakor), a felfelé mutató nyílra kattintva csökkenti a pozíció értékét, és a lefelé mutató nyílra kattintva növeli azt.

A pajtásablak nélküli pörgőgomb-vezérlő egyfajta egyszerűsített görgetősávként működik. A tabulátor vezérlőelemek például néha egy spin gomb vezérlőelemet is megjelenítenek, amely lehetővé teszi, hogy a felhasználó további lapokat görgethessen a nézetbe.

További információ a CSpinButtonCtrlhasználatáról: Vezérlők és A CSpinButtonCtrlhasználata.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CSpinButtonCtrl

Követelmények

fejléc: afxcmn.h

CSpinButtonCtrl::Létrehozás

Létrehoz egy pörgetési gomb vezérlőt, és csatolja egy CSpinButtonCtrl objektumhoz.

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

Paraméterek

dwStyle
A pörgetés gomb vezérlőelem stílusát adja meg. A vezérlőre a spin gomb vezérlőstílusainak bármilyen kombinációját alkalmazhatja. Ezeket a stílusokat a Windows SDK Up-Down vezérlőstílusai ismertetik.

Megadja a pörgetés gomb vezérlőjének méretét és pozícióját. Lehet CRect objektum vagy RECT szerkezet

pParentWnd
A pörgetés gomb vezérlőjének szülőablakára mutató mutató, általában egy CDialog. Nem lehet NULL.

nID
Megadja a pörgetési gomb vezérlőelem azonosítóját.

Visszaadott érték

Nonzero, ha az inicializálás sikeres volt; egyéb esetben 0.

Megjegyzések

Két lépésben kell létrehoznia egy CSpinButtonCtrl objektumot. Először hívja meg a konstruktort, majd hívja meg a Create, amely létrehozza a spin gomb vezérlőt, és csatolja a CSpinButtonCtrl objektumhoz.

Ha bővített ablakstílusokkal szeretne spin gomb vezérlőelemet létrehozni, hívja meg CSpinButtonCtrl::CreateEx a Createhelyett.

CSpinButtonCtrl::CreateEx

Létrehoz egy vezérlőt (egy gyermekablakot), és társítja azt a CSpinButtonCtrl objektummal.

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

Paraméterek

dwExStyle
A létrehozott vezérlőelem kiterjesztett stílusát adja meg. A bővített windowsstílusok listáját a Windows SDK CreateWindowExdwExStyle paraméterében találja.

dwStyle
A pörgetés gomb vezérlőelem stílusát adja meg. A vezérlőre a spin gomb vezérlőstílusainak bármilyen kombinációját alkalmazhatja. Ezeket a stílusokat a Windows SDK Up-Down vezérlőstílusai ismertetik.

Hivatkozás egy RECT szerkezetre, amely leírja a létrehozandó ablak méretét és pozícióját pParentWndügyfélkoordinátáiban.

pParentWnd
A vezérlő szülőablakára mutató mutató.

nID
A vezérlő gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A Létrehozása helyett CreateEx használata a Bővített Windows-stílusok WS_EX_ által megadott kiterjesztett Windows-stílusok alkalmazásához.

CSpinButtonCtrl::CSpinButtonCtrl

Egy CSpinButtonCtrl objektumot hoz létre.

CSpinButtonCtrl();

CSpinButtonCtrl::GetAccel

Lekéri a gyorsítási információkat a spin gomb vezérlőjéhez.

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

Paraméterek

nAccel
A pAcceláltal megadott tömb elemeinek száma.

pAccel
A gyorsítási információkat fogadó UDACCEL struktúrák tömbje.

Visszaadott érték

A lekért gyorsítószerkezetek száma.

CSpinButtonCtrl::GetBase

Lekéri a spin gomb vezérlőjének aktuális alapjait.

UINT GetBase() const;

Visszaadott érték

Az aktuális alapérték.

CSpinButtonCtrl::GetBuddy

Az aktuális haverablakra mutató mutatót kér le.

CWnd* GetBuddy() const;

Visszaadott érték

Mutató az aktuális pajtásablakra.

CSpinButtonCtrl::GetPos

Lekéri a spin gomb vezérlőjének aktuális pozícióját.

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

Paraméterek

lpbError
Egy nulla értékű logikai értékre mutató mutató, ha az érték lekérése sikeresen megtörtént, vagy hiba esetén nem nulla. Ha ez a paraméter NULL értékre van állítva, a rendszer nem jelenti a hibákat.

Visszaadott érték

Az első verzió az alacsony sorrendű szó 16 bites aktuális pozícióját adja vissza. Hiba esetén a magasrendű szó nem ero.

A második verzió a 32 bites pozíciót adja vissza.

Megjegyzések

Amikor feldolgozza a visszaadott értéket, a vezérlő frissíti az aktuális pozícióját a haver ablak felirata alapján. A vezérlő hibát ad vissza, ha nincs pajtásablak, vagy ha a felirat érvénytelen vagy tartományon kívüli értéket ad meg.

CSpinButtonCtrl::GetRange

Lekéri a spin gomb vezérlőelem felső és alsó korlátait (tartományát).

DWORD GetRange() const;

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

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

Paraméterek

alacsonyabb
Hivatkozás egy olyan egész számra, amely a vezérlőelem alsó korlátját kapja.

felső
Hivatkozás egy olyan egész számra, amely megkapja a vezérlőelem felső korlátját.

Visszaadott érték

Az első verzió egy 32 bites értéket ad vissza, amely a felső és az alsó korlátot tartalmazza. Az alacsonyrendű szó a vezérlőelem felső határa, a felsőrendű szó pedig az alsó korlát.

Megjegyzések

A tagfüggvény GetRange32 lekéri a spin gomb vezérlőelem tartományát 32 bites egész számként.

CSpinButtonCtrl::SetAccel

Beállítja a pörgetési gomb vezérlőjének gyorsulását.

BOOL SetAccel(
    int nAccel,
    UDACCEL* pAccel);

Paraméterek

nAccel
Az pAcceláltal megadott UDACCEL struktúrák száma.

pAccel
Gyorsítási információkat tartalmazó UDACCEL-struktúrák tömbje. Az elemeket növekvő sorrendbe kell rendezni a nSec tag alapján.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

CSpinButtonCtrl::SetBase

Beállítja a spin gomb vezérlőjének alapját.

int SetBase(int nBase);

Paraméterek

nBase
Új alapérték a vezérlőelemhez. Ez lehet 10 decimális vagy 16 hexadecimális.

Visszaadott érték

Az előző alapérték, ha sikeres, vagy nulla, ha érvénytelen alap van megadva.

Megjegyzések

Az alapérték határozza meg, hogy a pajtás ablak számokat jelenít-e meg decimális vagy hexadecimális számjegyekben. A hexadecimális számok mindig aláíratlanok; decimális számok vannak aláírva.

CSpinButtonCtrl::SetBuddy

Beállítja a pajtásablakot a spin gomb vezérlőjéhez.

CWnd* SetBuddy(CWnd* pWndBuddy);

Paraméterek

pWndBuddy
Mutasson az új pajtásablakra.

Visszaadott érték

Mutató az előző pajtásablakhoz.

Megjegyzések

A spin vezérlőelem szinte mindig egy másik ablakhoz van társítva, például egy szerkesztési vezérlőhöz, amely bizonyos tartalmakat jelenít meg. Ezt a másik ablakot a spin vezérlő "haverjának" nevezik.

CSpinButtonCtrl::SetPos

Beállítja a pörgetés gomb vezérlőjének aktuális pozícióját.

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

Paraméterek

nPos
Új pozíció a vezérlőhöz. Ennek az értéknek a vezérlőelem felső és alsó korlátja által megadott tartományban kell lennie.

Visszaadott érték

Az előző pozíció (SetPos16 bites pontossága, SetPos3232 bites pontossága).

Megjegyzések

SetPos32 beállítja a 32 bites pozíciót.

CSpinButtonCtrl::SetRange

A spin gomb vezérlőelem felső és alsó korlátját (tartományát) állítja be.

void SetRange(
    short nLower,
    short nUpper);

void SetRange32(
    int nLower,
    int nUpper);

Paraméterek

nLower és nUpper
A vezérlőelem felső és alsó korlátai. A SetRangeesetében egyik korlát sem lehet nagyobb UD_MAXVAL vagy kisebb, mint UD_MINVAL; ezenkívül a két korlát közötti különbség nem haladhatja meg a UD_MAXVAL. SetRange32 nem korlátozza a korlátokat; használjon egész számokat.

Megjegyzések

A tagfüggvény SetRange32 beállítja a 32 bites tartományt a spin gomb vezérlőjéhez.

Jegyzet

A pörgetés gomb alapértelmezett tartománya nullára (0) és a minimum 100-ra van állítva. Mivel a maximális érték kisebb, mint a minimális érték, a felfelé mutató nyílra kattintva csökkenti a pozíciót, és a lefelé mutató nyílra kattintva növeli azt. Ezeket az értékeket CSpinButtonCtrl::SetRange módosíthatja.

Lásd még:

MFC-minta CMNCTRL2
CWnd osztály
hierarchiadiagram
CSliderCtrl osztály