CSpinButtonCtrl – třída

Poskytuje funkce běžného ovládacího prvku číselníku windows.

Syntaxe

class CSpinButtonCtrl : public CWnd

Členové

Veřejné konstruktory

Název	Popis
CSpinButtonCtrl::CSpinButtonCtrl	CSpinButtonCtrl Vytvoří objekt.

Veřejné metody

Název	Popis
CSpinButtonCtrl::Create	Vytvoří ovládací prvek číselníku a připojí ho k objektu CSpinButtonCtrl .
CSpinButtonCtrl::CreateEx	Vytvoří ovládací prvek číselníku se zadanými rozšířenými styly Windows a připojí ho k objektu CSpinButtonCtrl .
CSpinButtonCtrl::GetAccel	Načte informace o akceleraci pro ovládací prvek číselníku.
CSpinButtonCtrl::GetBase	Načte aktuální základ pro ovládací prvek číselníku.
CSpinButtonCtrl::GetBuddy	Načte ukazatel na aktuální okno pro kamarády.
CSpinButtonCtrl::GetPos	Načte aktuální pozici ovládacího prvku číselníku.
CSpinButtonCtrl::GetRange	Načte horní a dolní limity (rozsah) pro ovládací prvek číselníku.
CSpinButtonCtrl::SetAccel	Nastaví akceleraci pro ovládací prvek číselníku.
CSpinButtonCtrl::SetBase	Nastaví základ pro ovládací prvek číselníku.
CSpinButtonCtrl::SetBuddy	Nastaví okno kamaráda pro ovládací prvek číselníku.
CSpinButtonCtrl::SetPos	Nastaví aktuální pozici ovládacího prvku.
CSpinButtonCtrl::SetRange	Nastaví horní a dolní limity (rozsah) pro ovládací prvek číselníku.

Poznámky

"Ovládací prvek číselníku" (označovaný také jako ovládací prvek nahoru)) je dvojice tlačítek se šipkami, na které uživatel může kliknout a zvýšit nebo snížit hodnotu, například pozici posouvání nebo číslo zobrazené v doprovodném ovládacím prvku. Hodnota přidružená k ovládacímu prvku číselníku se nazývá jeho aktuální pozice. Ovládací prvek číselníku se nejčastěji používá u doprovodné ovládacího prvku označovaného jako "okno kamaráda".

Tento ovládací prvek (a proto CSpinButtonCtrl třída) je k dispozici pouze pro programy spuštěné v systémech Windows 95/98 a systém Windows NT verze 3.51 a novější.

Pro uživatele často ovládací prvek číselníku a jeho kámoše vypadají jako jeden ovládací prvek. Můžete určit, že ovládací prvek číselníku automaticky umístí sám sebe vedle jeho okna kamaráda a že automaticky nastaví titulek okna kamaráda na jeho aktuální pozici. Pomocí ovládacího prvku číselníku s ovládacím prvku pro úpravy můžete uživatele vyzvat k zadání číselného vstupu.

Kliknutím na šipku nahoru se aktuální pozice posune směrem k maximu a kliknutím na šipku dolů se aktuální pozice přesune směrem k minimu. Ve výchozím nastavení je minimum 100 a maximum je 0. Kdykoli je minimální nastavení větší než maximální nastavení (například při použití výchozího nastavení), kliknutím na šipku nahoru se zmenší hodnota pozice a kliknutím na šipku dolů se zvětší.

Ovládací prvek číselníku bez okna pro kamarády funguje jako druh zjednodušeného posuvníku. Například ovládací prvek karty někdy zobrazuje ovládací prvek číselníku, který uživateli umožňuje posouvání dalších karet do zobrazení.

Další informace o použití CSpinButtonCtrlnaleznete v tématu Ovládací prvky a použití CSpinButtonCtrl.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CSpinButtonCtrl

Požadavky

Hlavička: afxcmn.h

CSpinButtonCtrl::Create

Vytvoří ovládací prvek číselníku a připojí ho k objektu CSpinButtonCtrl .

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

Parametry

dwStyle
Určuje styl ovládacího prvku číselníku. U ovládacího prvku použijte libovolnou kombinaci stylů ovládacích prvků číselníku. Tyto styly jsou popsány v ovládacího prvku Up-Down v sadě Windows SDK.

Rect
Určuje velikost a pozici ovládacího prvku číselníku. Může to být objekt CRect nebo struktura RECT .

pParentWnd
Ukazatel na nadřazené okno ovládacího prvku číselníku, obvykle CDialog Nesmí mít hodnotu NULL.

Nid
Určuje ID ovládacího prvku číselníku.

Návratová hodnota

Nenulové, pokud byla inicializace úspěšná; jinak 0.

Poznámky

Objekt vytvoříte CSpinButtonCtrl ve dvou krocích Nejprve zavoláte konstruktor a pak zavoláte Create, který vytvoří ovládací prvek číselníku a připojí ho k objektu CSpinButtonCtrl .

Chcete-li vytvořit ovládací prvek číselníku s rozšířenými styly oken, zavolejte CSpinButtonCtrl::CreateEx místo Create.

CSpinButtonCtrl::CreateEx

Vytvoří ovládací prvek (podřízené okno) a přidruží ho k objektu CSpinButtonCtrl .

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

Parametry

dwExStyle
Určuje rozšířený styl vytvářeného ovládacího prvku. Seznam rozšířených stylů windows naleznete v části dwExStyle parametr pro CreateWindowEx v sadě Windows SDK.

dwStyle
Určuje styl ovládacího prvku číselníku. U ovládacího prvku použijte libovolnou kombinaci stylů ovládacích prvků číselníku. Tyto styly jsou popsány v ovládacího prvku Up-Down v sadě Windows SDK.

Rect
Odkaz na strukturu RECT popisující velikost a umístění okna, které se má vytvořit, v souřadnicích klienta pParentWnd.

pParentWnd
Ukazatel na okno, které je nadřazeným objektem ovládacího prvku.

Nid
ID podřízeného okna ovládacího prvku.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

CreateEx použijte rozšířené styly Windows určené před WS_EX_ rozšířeného stylu Windows.

CSpinButtonCtrl::CSpinButtonCtrl

CSpinButtonCtrl Vytvoří objekt.

CSpinButtonCtrl();

CSpinButtonCtrl::GetAccel

Načte informace o akceleraci pro ovládací prvek číselníku.

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

Parametry

nAccel
Počet prvků v matici určené funkcí pAccel.

pAccel
Ukazatel na pole struktur UDACCEL , které přijímají informace o akceleraci.

Návratová hodnota

Počet načtených struktur akcelerátoru

CSpinButtonCtrl::GetBase

Načte aktuální základ pro ovládací prvek číselníku.

UINT GetBase() const;

Návratová hodnota

Aktuální základní hodnota.

CSpinButtonCtrl::GetBuddy

Načte ukazatel na aktuální okno pro kamarády.

CWnd* GetBuddy() const;

Návratová hodnota

Ukazatel na aktuální okno pro kamarády.

CSpinButtonCtrl::GetPos

Načte aktuální pozici ovládacího prvku číselníku.

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

Parametry

Chyba lpb
Ukazatel na logickou hodnotu nastavenou na nulu, pokud je hodnota úspěšně načtena nebo nenulová, pokud dojde k chybě. Pokud je tento parametr nastaven na hodnotu NULL, chyby se neoznamují.

Návratová hodnota

První verze vrátí 16bitovou aktuální pozici ve slově s nízkým pořadím. Pokud došlo k chybě, je slovo s vysokým pořadím nenulové.

Druhá verze vrátí 32bitovou pozici.

Poznámky

Když zpracuje vrácenou hodnotu, ovládací prvek aktualizuje aktuální pozici na základě titulku okna kamaráda. Ovládací prvek vrátí chybu, pokud není k dispozici žádné okno nebo pokud titulek určuje neplatnou nebo mimo rozsah hodnotu.

CSpinButtonCtrl::GetRange

Načte horní a dolní limity (rozsah) pro ovládací prvek číselníku.

DWORD GetRange() const;

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

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

Parametry

dolní
Odkaz na celé číslo, které obdrží dolní limit ovládacího prvku.

horní
Odkaz na celé číslo, které obdrží horní limit ovládacího prvku.

Návratová hodnota

První verze vrátí 32bitovou hodnotu obsahující horní a dolní limity. Slovo s nízkým pořadím je horní limit ovládacího prvku a slovo s vysokým pořadím je dolní limit.

Poznámky

Členská funkce GetRange32 načte rozsah ovládacího prvku číselníku jako 32bitové celé číslo.

CSpinButtonCtrl::SetAccel

Nastaví akceleraci pro ovládací prvek číselníku.

BOOL SetAccel(
    int nAccel,
    UDACCEL* pAccel);

Parametry

nAccel
Počet struktur UDACCEL určených nástrojem pAccel.

pAccel
Ukazatel na pole struktur UDACCEL, které obsahují informace o akceleraci. Prvky by měly být seřazeny vzestupně podle člena nSec .

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

CSpinButtonCtrl::SetBase

Nastaví základ pro ovládací prvek číselníku.

int SetBase(int nBase);

Parametry

nBase
Nová základní hodnota ovládacího prvku Může to být 10 pro desetinné číslo nebo 16 pro šestnáctkové.

Návratová hodnota

Předchozí základní hodnota, pokud je úspěšná, nebo nula, pokud je poskytnuta neplatná základna.

Poznámky

Základní hodnota určuje, zda okno buddy zobrazuje čísla v desítkových nebo šestnáctkových číslicích. Šestnáctková čísla jsou vždy bez znaménka; desetinná čísla jsou podepsána.

CSpinButtonCtrl::SetBuddy

Nastaví okno kamaráda pro ovládací prvek číselníku.

CWnd* SetBuddy(CWnd* pWndBuddy);

Parametry

pWndBuddy
Ukazatel na nové okno pro kamarády.

Návratová hodnota

Ukazatel na předchozí okno kamaráda.

Poznámky

Číselník je téměř vždy přidružený k jinému okně, například ovládacímu prvku pro úpravy, který zobrazuje nějaký obsah. Toto druhé okno se nazývá "kamarád" číselníku.

CSpinButtonCtrl::SetPos

Nastaví aktuální pozici pro ovládací prvek číselníku.

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

Parametry

NPos
Nové umístění ovládacího prvku Tato hodnota musí být v rozsahu určeném horním a dolním limitem ovládacího prvku.

Návratová hodnota

Předchozí pozice (16bitová přesnost pro SetPos, 32bitová přesnost pro SetPos32).

Poznámky

SetPos32 nastaví 32bitovou pozici.

CSpinButtonCtrl::SetRange

Nastaví horní a dolní limity (rozsah) pro ovládací prvek číselníku.

void SetRange(
    short nLower,
    short nUpper);

void SetRange32(
    int nLower,
    int nUpper);

Parametry

nLower a nUpper
Horní a dolní limity pro ovládací prvek. U SetRange, ani jeden limit nemůže být větší než UD_MAXVAL nebo menší než UD_MINVAL; kromě toho rozdíl mezi těmito dvěma limity nemůže překročit UD_MAXVAL. SetRange32 neumisťuje žádná omezení limitů; použijte všechna celá čísla.

Poznámky

Členová funkce SetRange32 nastaví 32bitový rozsah pro ovládací prvek číselníku.

Poznámka:

Výchozí rozsah číselníku má maximální hodnotu nastavenou na nulu (0) a minimální hodnotu nastavenou na 100. Protože maximální hodnota je menší než minimální hodnota, kliknutím na šipku nahoru se zmenší pozice a kliknutím na šipku dolů ji zvětšíte. Slouží CSpinButtonCtrl::SetRange k úpravě těchto hodnot.

Viz také

Ukázková CMNCTRL2 MFC
CWnd – třída
Graf hierarchie
CSliderCtrl – třída