Udostępnij przez


Funkcje składowe kontrolki suwaka

Aplikacja może wywołać funkcje składowe kontrolki suwaka, aby pobrać informacje o kontrolce suwaka (CSliderCtrl) i zmienić jej cechy.

Aby pobrać położenie suwaka (czyli wartość wybrana przez użytkownika), użyj funkcji składowej GetPos . Aby ustawić położenie suwaka, użyj funkcji składowej SetPos . W dowolnym momencie możesz użyć funkcji składowej VerifyPos , aby upewnić się, że suwak znajduje się między wartościami minimalnymi i maksymalnymi.

Zakres kontrolki suwaka to zestaw ciągłych wartości, które może reprezentować kontrolka suwaka. Większość aplikacji używa funkcji składowej SetRange , aby ustawić zakres kontrolki suwaka po jej utworzeniu. Aplikacje mogą dynamicznie zmieniać zakres po utworzeniu kontrolki suwaka przy użyciu funkcji składowych SetRangeMax i SetRangeMin . Aplikacja, która umożliwia dynamiczne zmianę zakresu, zwykle pobiera końcowe ustawienia zakresu, gdy użytkownik zakończył pracę z kontrolką suwaka. Aby pobrać te ustawienia, użyj funkcji członkowskich: GetRange, GetRangeMax i GetRangeMin.

Aplikacja może używać stylu TBS_AUTOTICKS, aby automatycznie wyświetlać znaczniki suwaka. Jeśli aplikacja musi kontrolować położenie lub częstotliwość znaczników, można użyć wielu funkcji składowych.

Aby ustawić położenie znacznika, aplikacja może użyć funkcji składowej SetTic. Funkcja składowa SetTicFreq umożliwia aplikacji ustawianie znaczników, które pojawiają się w regularnych odstępach czasu w zakresie suwaka kontrolki. Na przykład aplikacja może użyć tej funkcji składowej, aby wyświetlić tylko 10 kresek w zakresie od 1 do 100.

Aby pobrać indeks zakresu odpowiadający znacznikowi, użyj funkcji składowej GetTic. Funkcja składowa GetTicArray pobiera tablicę tych indeksów. Aby pobrać położenie znacznika we współrzędnych klienta, użyj funkcji składowej GetTicPos. Aplikacja może pobrać liczbę znaczników przy użyciu funkcji składowej GetNumTics .

Funkcja składowa ClearTics usuwa wszystkie znaczniki zaznaczenia kontrolki suwaka.

Rozmiar linijki kontrolki suwaka określa, jak daleko suwak przesuwa się, gdy aplikacja odbiera komunikat o powiadomieniu TB_LINEDOWN lub TB_LINEUP. Podobnie rozmiar strony określa odpowiedź na komunikaty powiadomień TB_PAGEDOWN i TB_PAGEUP. Aplikacje mogą pobierać i ustawiać wartości rozmiaru wiersza i strony przy użyciu funkcji składowych GetLineSize, SetLineSize, GetPageSize i SetPageSize .

Aplikacja może używać funkcji członkowskich do pobierania wymiarów kontrolki suwaka. Funkcja składowa GetThumbRect pobiera prostokąt ograniczenia suwaka. Funkcja składowa GetChannelRect pobiera prostokąt ograniczenia dla kanału kontrolki suwaka. (Kanał to obszar, na którym przesuwa się suwak i który zawiera wyróżnienie po wybraniu zakresu).

Jeśli kontrolka suwaka ma styl TBS_ENABLESELRANGE, użytkownik może wybrać zakres ciągłych wartości. Wiele funkcji składowych umożliwia dynamiczne dostosowywanie zakresu wyboru. Funkcja członkowska SetSelection ustawia pozycje początkową i końcową zaznaczenia. Po zakończeniu ustawiania zakresu wyboru przez użytkownika aplikacja może pobrać ustawienia przy użyciu funkcji składowej GetSelection . Aby usunąć zaznaczenie użytkownika, użyj funkcji składowej ClearSel.

Zobacz także

Korzystanie z CSliderCtrl
Sterowanie