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

Jméno popis
CSliderCtrl::CSliderCtrl CSliderCtrl Vytvoří objekt.

Veřejné metody

Jméno 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.

Vrácená 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í CreateExCreate.

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.

Vrácená 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.

Vrácená 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;

Vrácená 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;

Vrácená 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;

Vrácená 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;

Vrácená 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;

Vrácená 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;

Vrácená 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;

Vrácená 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í

Vrácená 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;

Vrácená 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í

Vrácená 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;

Vrácená 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.

Vrácená 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.

Vrácená 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.

Vrácená 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.

Vrácená 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.

Vrácená 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