CSliderCtrl Třída

Poskytuje funkce běžného ovládacího prvku Posuvník systému Windows.

Syntaxe

class CSliderCtrl : public CWnd

Členové

Veřejné konstruktory

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

Veřejné metody

Název	Popis
CSliderCtrl::ClearSel	Vymaže aktuální výběr v ovládacím prvku posuvník.
CSliderCtrl::ClearTics	Odebere aktuální značky z posuvníku.
CSliderCtrl::Create	Vytvoří ovládací prvek posuvníku a připojí ho k objektu CSliderCtrl .
CSliderCtrl::CreateEx	Vytvoří ovládací prvek posuvníku se zadanými rozšířenými styly Windows a připojí ho k objektu CSliderCtrl .
CSliderCtrl::GetBuddy	Načte úchyt do ovládacího prvku posuvníku v daném umístění.
CSliderCtrl::GetChannelRect	Načte velikost kanálu posuvníku.
CSliderCtrl::GetLineSize	Načte velikost čáry ovládacího prvku posuvník.
CSliderCtrl::GetNumTics	Načte počet značek v ovládacím prvku posuvníku.
CSliderCtrl::GetPageSize	Načte velikost stránky ovládacího prvku posuvník.
CSliderCtrl::GetPos	Načte aktuální pozici posuvníku.
CSliderCtrl::GetRange	Načte minimální a maximální umístění posuvníku.
CSliderCtrl::GetRangeMax	Načte maximální pozici posuvníku.
CSliderCtrl::GetRangeMin	Načte minimální pozici posuvníku.
CSliderCtrl::GetSelection	Načte oblast aktuálního výběru.
CSliderCtrl::GetThumbLength	Načte délku posuvníku v aktuálním ovládacím prvku trackbar.
CSliderCtrl::GetThumbRect	Načte velikost palce ovládacího prvku posuvníku.
CSliderCtrl::GetTic	Načte pozici zadané značky zaškrtnutí.
CSliderCtrl::GetTicArray	Načte pole pozic značky zaškrtnutí pro ovládací prvek posuvníku.
CSliderCtrl::GetTicPos	Načte pozici zadané značky zaškrtnutí v souřadnicích klienta.
CSliderCtrl::GetToolTips	Načte popisovač do ovládacího prvku popisku přiřazeného ovládacímu prvku posuvník, pokud existuje.
CSliderCtrl::SetBuddy	Přiřadí okno jako okno pro posuvník.
CSliderCtrl::SetLineSize	Nastaví velikost čáry posuvníku.
CSliderCtrl::SetPageSize	Nastaví velikost stránky ovládacího prvku posuvník.
CSliderCtrl::SetPos	Nastaví aktuální pozici posuvníku.
CSliderCtrl::SetRange	Nastaví minimální a maximální umístění posuvníku.
CSliderCtrl::SetRangeMax	Nastaví maximální pozici posuvníku.
CSliderCtrl::SetRangeMin	Nastaví minimální pozici posuvníku.
CSliderCtrl::SetSelection	Nastaví rozsah aktuálního výběru.
CSliderCtrl::SetThumbLength	Nastaví délku posuvníku v aktuálním ovládacím prvku trackbar.
CSliderCtrl::SetTic	Nastaví pozici zadané značky zaškrtnutí.
CSliderCtrl::SetTicFreq	Nastaví frekvenci značek na ovládací prvek posuvníku.
CSliderCtrl::SetTipSide	Umístí ovládací prvek popisu, který používá ovládací prvek trackbaru.
CSliderCtrl::SetToolTips	Přiřadí ovládací prvek popisu posuvníku.

Poznámky

Ovládací prvek posuvníku (označovaný také jako trackbar) je okno obsahující posuvník a volitelné značky. Když uživatel přesune posuvník pomocí myši nebo směrových kláves, ovládací prvek odešle zprávy s oznámením o změně.

Ovládací prvky posuvníku jsou užitečné, pokud chcete, aby uživatel vybral samostatnou hodnotu nebo sadu po sobě jdoucích hodnot v oblasti. Můžete například pomocí ovládacího prvku posuvník povolit uživateli nastavit rychlost opakování klávesnice přesunutím posuvníku na danou značku zaškrtnutí.

Tento ovládací prvek (a proto CSliderCtrl 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ší.

Posuvník se přesune v přírůstcích, které zadáte při vytváření. Pokud například určíte, že posuvník by měl mít rozsah pěti, posuvník může zabírat pouze šest pozic: pozici na levé straně ovládacího prvku posuvníku a jednu pozici pro každý přírůstek v oblasti. Každá z těchto pozic je obvykle identifikována značkou zaškrtnutí.

Posuvník vytvoříte pomocí konstruktoru Create a členské funkce CSliderCtrl. Po vytvoření ovládacího prvku posuvníku můžete pomocí členských funkcí CSliderCtrl změnit mnoho jeho vlastností. Změny, které můžete provést, zahrnují nastavení minimální a maximální polohy posuvníku, značky kreslení, nastavení rozsahu výběru a přemístění posuvníku.

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

Hierarchie dědičnosti

CObject

CCmdTarget

CWnd

CSliderCtrl

Požadavky

Záhlaví: afxcmn.h

CSliderCtrl::ClearSel

Vymaže aktuální výběr v ovládacím prvku posuvník.

void ClearSel(BOOL bRedraw = FALSE);

Parametry

bRedraw
Překreslit příznak. Pokud je TRUEtento parametr , posuvník se po vymazání výběru překreslí. V opačném případě se posuvník nepřekreslí.

CSliderCtrl::ClearTics

Odebere aktuální značky z posuvníku.

void ClearTics(BOOL bRedraw = FALSE);

Parametry

bRedraw
Překreslit příznak. Pokud je TRUEtento parametr , posuvník se překreslí za zaškrtnutím značek. V opačném případě se posuvník nepřekreslí.

CSliderCtrl::Create

Vytvoří ovládací prvek posuvníku a připojí ho k objektu CSliderCtrl .

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

Parametry

dwStyle
Určuje styl ovládacího prvku posuvníku. Na ovládací prvek použijte libovolnou kombinaci stylů ovládacích prvků posuvníku popsaných v sadě Windows SDK.

rect
Určuje velikost a umístění ovládacího prvku posuvníku. Může to být CRect objekt nebo RECT struktura.

pParentWnd
Určuje nadřazené okno ovládacího prvku posuvníku, obvykle .CDialog Nesmí to být NULL.

nID
Určuje ID ovládacího prvku posuvníku.

Návratová hodnota

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

Poznámky

Sestavíte ho CSliderCtrl ve dvou krocích. Nejprve zavolejte konstruktor a potom volání Create, který vytvoří posuvník ovládací prvek a připojí ho k objektu CSliderCtrl .

V závislosti na hodnotách nastavených dwStylepro ovládací prvek posuvník může mít svislou nebo vodorovnou orientaci. Může mít značky značek na obou stranách, na obou stranách nebo na obou stranách. Dá se také použít k určení rozsahu po sobě jdoucích hodnot.

Chcete-li použít rozšířené styly oken na ovládací prvek posuvník, místo volání CreateEx Create.

CSliderCtrl::CreateEx

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

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 najdete v parametru dwExStyle sady CreateWindowEx Windows SDK.

dwStyle
Určuje styl ovládacího prvku posuvníku. Na ovládací prvek použijte libovolnou kombinaci stylů ovládacích prvků posuvníku popsaných v sadě Windows SDK.

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

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

Create Místo CreateEx použití rozšířených stylů Windows určených předmětu WS_EX_rozšířeného stylu Windows .

CSliderCtrl::CSliderCtrl

CSliderCtrl Vytvoří objekt.

CSliderCtrl();

CSliderCtrl::GetBuddy

Načte úchyt do ovládacího prvku posuvníku v daném umístění.

CWnd* GetBuddy(BOOL fLocation = TRUE) const;

Parametry

fLocation
Logická hodnota, která označuje, který ze dvou popisovačů okna pro kamarády se má načíst. Může to být jedna z následujících hodnot:

• TRUE Načte úchyt na levé straně posuvníku. Pokud ovládací prvek posuvník používá TBS_VERT styl, zpráva načte kamaráda nad posuvníkem.

• FALSE Načte úchyt napravo od posuvníku. Pokud ovládací prvek posuvník používá TBS_VERT styl, zpráva načte kamaráda pod posuvníkem.

Návratová hodnota

Ukazatel na CWnd objekt, který je okno buddy v umístění určeném fLocationnástrojem , nebo NULL pokud v tomto umístění neexistuje žádné okno pro kamarády.

Poznámky

Tato členová funkce implementuje chování zprávy TBM_GETBUDDYWin32, jak je popsáno v sadě Windows SDK. Popis stylů ovládacích prvků posuvníku naleznete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

CSliderCtrl::GetChannelRect

Načte velikost a umístění ohraničujícího obdélníku pro kanál ovládacího prvku posuvníku.

void GetChannelRect(LPRECT lprc) const;

Parametry

lprc
Ukazatel na CRect objekt, který obsahuje velikost a umístění ohraničujícího obdélníku kanálu při vrácení funkce.

Poznámky

Kanál je oblast, přes kterou se posuvník přesune a který obsahuje zvýraznění, když je vybrána oblast.

CSliderCtrl::GetLineSize

Načte velikost čáry pro ovládací prvek posuvníku.

int GetLineSize() const;

Návratová hodnota

Velikost čáry pro ovládací prvek posuvníku.

Poznámky

Velikost čáry ovlivňuje, kolik posuvníku se přesune pro TB_LINEUP oznámení a TB_LINEDOWN oznámení. Výchozí nastavení pro velikost čáry je 1.

CSliderCtrl::GetNumTics

Načte počet značek v ovládacím prvku posuvníku.

UINT GetNumTics() const;

Návratová hodnota

Počet značek v ovládacím prvku posuvník.

CSliderCtrl::GetPageSize

Načte velikost stránky pro ovládací prvek posuvníku.

int GetPageSize() const;

Návratová hodnota

Velikost stránky pro ovládací prvek posuvník.

Poznámky

Velikost stránky ovlivňuje, kolik posuvníku se přesune pro TB_PAGEUP oznámení.TB_PAGEDOWN

CSliderCtrl::GetPos

Načte aktuální pozici posuvníku v ovládacím prvku posuvník.

int GetPos() const;

Návratová hodnota

Aktuální pozice.

CSliderCtrl::GetRange

Načte maximální a minimální pozice posuvníku v ovládacím prvku posuvník.

void GetRange(
    int& nMin,
    int& nMax) const;

Parametry

nMin
Odkaz na celé číslo, které obdrží minimální pozici.

nMax
Odkaz na celé číslo, které obdrží maximální pozici.

Poznámky

Tato funkce zkopíruje hodnoty do celých čísel, na která nMin odkazuje a nMax.

CSliderCtrl::GetRangeMax

Načte maximální pozici posuvníku v ovládacím prvku posuvník.

int GetRangeMax() const;

Návratová hodnota

Maximální umístění ovládacího prvku.

CSliderCtrl::GetRangeMin

Načte minimální pozici posuvníku v ovládacím prvku posuvník.

int GetRangeMin() const;

Návratová hodnota

Minimální pozice ovládacího prvku.

CSliderCtrl::GetSelection

Načte počáteční a koncové pozice aktuálního výběru v ovládacím prvku posuvníku.

void GetSelection(
    int& nMin,
    int& nMax) const;

Parametry

nMin
Odkaz na celé číslo, které obdrží počáteční pozici aktuálního výběru.

nMax
Odkaz na celé číslo, které obdrží koncovou pozici aktuálního výběru.

CSliderCtrl::GetThumbLength

Načte délku posuvníku v aktuálním ovládacím prvku trackbar.

int GetThumbLength() const;

Návratová hodnota

Délka posuvníku v pixelech.

Poznámky

Tato metoda odešle TBM_GETTHUMBLENGTH zprávu popsanou v sadě Windows SDK.

CSliderCtrl::GetThumbRect

Načte velikost a umístění ohraničujícího obdélníku posuvníku (palce) v ovládacím prvku posuvníku.

void GetThumbRect(LPRECT lprc) const;

Parametry

lprc
Ukazatel na CRect objekt, který obsahuje ohraničující obdélník posuvníku, když funkce vrátí.

CSliderCtrl::GetTic

Načte pozici značky zaškrtnutí v ovládacím prvku posuvníku.

int GetTic(int nTic) const;

Parametry

nTic
Index založený na nule identifikující značku zaškrtnutí

Návratová hodnota

Pozice zadané značky zaškrtnutí nebo - 1, pokud nTic neurčí platný index.

CSliderCtrl::GetTicArray

Načte adresu pole obsahující pozice značek posuvníku.

DWORD* GetTicArray() const;

Návratová hodnota

Adresa pole obsahující pozice značky zaškrtnutí pro ovládací prvek posuvníku.

CSliderCtrl::GetTicPos

Načte aktuální fyzickou polohu značky zaškrtnutí v ovládacím prvku posuvníku.

int GetTicPos(int nTic) const;

Parametry

nTic
Index založený na nule identifikující značku zaškrtnutí

Návratová hodnota

Fyzická pozice v souřadnicích klienta zadané značky zaškrtnutí nebo – 1, pokud nTic neurčí platný index.

CSliderCtrl::GetToolTips

Načte popisovač do ovládacího prvku popisku přiřazeného ovládacímu prvku posuvník, pokud existuje.

CToolTipCtrl* GetToolTips() const;

Návratová hodnota

Ukazatel na CToolTipCtrl objekt nebo NULL pokud se popisy nepoužívají. Pokud ovládací prvek posuvník styl nepoužívá TBS_TOOLTIPS , vrátí se hodnota NULL.

Poznámky

Tato členová funkce implementuje chování zprávy TBM_GETTOOLTIPSWin32, jak je popsáno v sadě Windows SDK. Všimněte si, že tato členová funkce vrátí CToolTipCtrl objekt místo popisovače ovládacímu prvku.

Popis stylů ovládacích prvků posuvníku naleznete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

CSliderCtrl::SetBuddy

Přiřadí okno jako okno pro posuvník.

CWnd* SetBuddy(
    CWnd* pWndBuddy,
    BOOL fLocation = TRUE);

Parametry

pWndBuddy
Ukazatel na CWnd objekt, který bude nastaven jako kamarád posuvníku.

fLocation
Hodnota určující umístění, ve kterém se má zobrazit okno buddy. Tato hodnota může být jedna z následujících možností:

• TRUE Pokud ovládací prvek trackbar používá TBS_HORZ styl, zobrazí se na levé straně panelu stopy. Pokud trackbar používá TBS_VERT styl, zobrazí se nad ovládacím panelem trackbaru.

• FALSE Pokud ovládací prvek trackbar používá TBS_HORZ styl, zobrazí se na pravé straně panelu stopy. Pokud trackbar používá TBS_VERT styl, zobrazí se pod ovládacím panelem trackbaru.

Návratová hodnota

Ukazatel na CWnd objekt, který byl dříve přiřazen k ovládacímu prvku posuvníku v daném umístění.

Poznámky

Tato členová funkce implementuje chování zprávy TBM_SETBUDDYWin32, jak je popsáno v sadě Windows SDK. Všimněte si, že tato členová funkce používá ukazatele na CWnd objekty místo popisovačů oken pro jeho návratovou hodnotu i parametr.

Popis stylů ovládacích prvků posuvníku naleznete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

CSliderCtrl::SetLineSize

Nastaví velikost čáry pro ovládací prvek posuvníku.

int SetLineSize(int nSize);

Parametry

nSize
Nová velikost čáry ovládacího prvku posuvník.

Návratová hodnota

Předchozí velikost řádku.

Poznámky

Velikost čáry ovlivňuje, kolik posuvníku se přesune pro TB_LINEUP oznámení a TB_LINEDOWN oznámení.

CSliderCtrl::SetPageSize

Nastaví velikost stránky pro ovládací prvek posuvníku.

int SetPageSize(int nSize);

Parametry

nSize
Nová velikost stránky ovládacího prvku posuvník.

Návratová hodnota

Velikost předchozí stránky.

Poznámky

Velikost stránky ovlivňuje, kolik posuvníku se přesune pro TB_PAGEUP oznámení.TB_PAGEDOWN

CSliderCtrl::SetPos

Nastaví aktuální pozici posuvníku v ovládacím prvku posuvníku.

void SetPos(int nPos);

Parametry

nPos
Určuje novou pozici posuvníku.

CSliderCtrl::SetRange

Nastaví rozsah (minimální a maximální pozice) posuvníku v ovládacím prvku posuvníku.

void SetRange(
    int nMin,
    int nMax,
    BOOL bRedraw = FALSE);

Parametry

nMin
Minimální pozice posuvníku.

nMax
Maximální umístění posuvníku.

bRedraw
Překreslit příznak. Pokud je TRUEtento parametr , posuvník se po nastavení rozsahu překreslí. V opačném případě se posuvník nepřekreslí.

CSliderCtrl::SetRangeMax

Nastaví maximální rozsah posuvníku v ovládacím prvku posuvník.

void SetRangeMax(
    int nMax,
    BOOL bRedraw = FALSE);

Parametry

nMax
Maximální umístění posuvníku.

bRedraw
Překreslit příznak. Pokud je TRUEtento parametr , posuvník se po nastavení rozsahu překreslí. V opačném případě se posuvník nepřekreslí.

CSliderCtrl::SetRangeMin

Nastaví minimální rozsah posuvníku v ovládacím prvku posuvník.

void SetRangeMin(
    int nMin,
    BOOL bRedraw = FALSE);

Parametry

nMin
Minimální pozice posuvníku.

bRedraw
Překreslit příznak. Pokud je TRUEtento parametr , posuvník se po nastavení rozsahu překreslí. V opačném případě se posuvník nepřekreslí.

CSliderCtrl::SetSelection

Nastaví počáteční a koncovou pozici pro aktuální výběr v ovládacím prvku posuvníku.

void SetSelection(
    int nMin,
    int nMax);

Parametry

nMin
Počáteční pozice posuvníku.

nMax
Koncová pozice posuvníku.

CSliderCtrl::SetThumbLength

Nastaví délku posuvníku v aktuálním ovládacím prvku trackbar.

void SetThumbLength(int nLength);

Parametry

nLength
[v] Délka posuvníku v pixelech

Poznámky

Tato metoda vyžaduje, aby byl ovládací prvek trackbar nastaven na TBS_FIXEDLENGTH styl.

Tato metoda odešle TBM_SETTHUMBLENGTH zprávu popsanou v sadě Windows SDK.

Příklad

První příklad kódu definuje proměnnou, m_sliderCtrlkterá se používá pro přístup k aktuálnímu ovládacímu prvku trackbar. Příklad také definuje proměnnou , thumbLengthkterá se používá k uložení výchozí délky komponenty trackbaru palce. Tyto proměnné se používají v dalším příkladu.

// Variable to access the slider control.
CSliderCtrl m_sliderCtrl;
// Length of the slider control's thumb.
int thumbLength;

Následující příklad kódu nastaví kryptografický prvek ovládacího prvku trackbar na dvojnásobek jeho výchozí délky.

// Add extra initialization.

// Modify the size of the slider control's thumb.
// First, set the TBS_FIXEDLENGTH style.
m_sliderCtrl.ModifyStyle(0, TBS_FIXEDLENGTH);
thumbLength = m_sliderCtrl.GetThumbLength();
m_sliderCtrl.SetThumbLength(thumbLength * 2);

// End extra initialization.

CSliderCtrl::SetTic

Nastaví pozici značky zaškrtnutí v ovládacím prvku posuvníku.

BOOL SetTic(int nTic);

Parametry

nTic
Pozice značky. Tento parametr musí zadat kladnou hodnotu.

Návratová hodnota

Nenulové, pokud je značka zaškrtnutí nastavena; jinak 0.

CSliderCtrl::SetTicFreq

Nastaví frekvenci zobrazení značek pomocí posuvníku.

void SetTicFreq(int nFreq);

Parametry

nFreq
Frekvence značek.

Poznámky

Pokud je například frekvence nastavená na hodnotu 2, zobrazí se značka zaškrtnutí pro každý další přírůstek v rozsahu posuvníku. Výchozí nastavení pro frekvenci je 1 (to znamená, že každé přírůstek v rozsahu je přidruženo ke značce zaškrtnutí).

Chcete-li použít tuto funkci, je nutné vytvořit ovládací prvek se stylem TBS_AUTOTICKS . Další informace najdete na webu CSliderCtrl::Create.

CSliderCtrl::SetTipSide

Umístí ovládací prvek popisu, který používá ovládací prvek trackbaru.

int SetTipSide(int nLocation);

Parametry

nLocation
Hodnota představující umístění, ve kterém se má zobrazit ovládací prvek popisu. Seznam možných hodnot najdete ve zprávě TBM_SETTIPSIDEWin32, jak je popsáno v sadě Windows SDK.

Návratová hodnota

Hodnota, která představuje předchozí umístění ovládacího prvku popisu. Vrácená hodnota se rovná jedné z možných hodnot pro nLocation.

Poznámky

Tato členová funkce implementuje chování zprávy TBM_SETTIPSIDEWin32, jak je popsáno v sadě Windows SDK. Posuvník ovládací prvky, které používají TBS_TOOLTIPS popisy zobrazení stylu Popis stylů ovládacích prvků posuvníku naleznete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

CSliderCtrl::SetToolTips

Přiřadí ovládací prvek popisu posuvníku.

void SetToolTips(CToolTipCtrl* pWndTip);

Parametry

pWndTip
Ukazatel na CToolTipCtrl objekt obsahující popisy, které se mají použít s posuvníkem.

Poznámky

Tato členová funkce implementuje chování zprávy TBM_SETTOOLTIPSWin32, jak je popsáno v sadě Windows SDK. Když se vytvoří ovládací prvek posuvníku TBS_TOOLTIPS se stylem, vytvoří výchozí ovládací prvek popisku, který se zobrazí vedle posuvníku a zobrazí aktuální pozici posuvníku. Popis stylů ovládacích prvků posuvníku naleznete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

Viz také

Mfc – ukázka CMNCTRL2
CWnd Třída
Graf hierarchie
CProgressCtrl Třída