Funkcje członkowskie formantu 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 składowych GetRange, GetRangeMax i GetRangeMin .
Aplikacja może używać stylu TBS_AUTOTICKS, aby automatycznie wyświetlać znaczniki znaczników suwaka. Jeśli aplikacja musi kontrolować położenie lub częstotliwość znaczników znaczników, można jednak użyć wielu funkcji składowych.
Aby ustawić położenie znacznika znacznika, aplikacja może użyć funkcji składowej SetTic . Funkcja składowa SetTicFreq umożliwia aplikacji ustawianie znaczników znaczników, które pojawiają się w regularnych odstępach czasu w zakresie kontrolki suwaka. Na przykład aplikacja może użyć tej funkcji składowej, aby wyświetlić tylko 10 znaczników znaczników w zakresie od 1 do 100.
Aby pobrać indeks w zakresie odpowiadającym znacznikowi znacznika, użyj funkcji składowej GetTic . Funkcja składowa GetTicArray pobiera tablicę tych indeksów. Aby pobrać położenie znacznika 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 wiersza kontrolki suwaka określa, jak daleko suwak przesuwa się, gdy aplikacja odbiera komunikat powiadomienia o 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 składowa SetSelection ustawia pozycje początkowe i końcowe zaznaczenia. Po zakończeniu ustawiania zakresu wyboru przez użytkownika aplikacja może pobrać ustawienia przy użyciu funkcji składowej GetSelection . Aby wyczyścić zaznaczenie użytkownika, użyj funkcji składowej ClearSel .