分享方式:


滑桿控制項成員函式

應用程式可以呼叫滑杆控制項的成員函式,以擷取滑杆控制項的相關資訊( CSliderCtrl ),並變更其特性。

若要擷取滑杆的位置(也就是使用者已選擇的值),請使用 GetPos 成員函式。 若要設定滑杆的位置,請使用 SetPos 成員函式。 您可以隨時使用 VerifyPos 成員函式,確定滑杆介於最小值和最大值之間。

滑杆控制項的範圍是滑杆控制項可以代表的連續值集。 大部分的應用程式都會 使用 SetRange 成員函式,在第一次建立滑杆控制項時設定其範圍。 應用程式可以使用 SetRangeMax SetRangeMin 成員函式,在滑杆控制項建立 之後動態改變範圍。 可讓範圍動態變更的應用程式,通常會在使用者完成使用滑杆控制項時擷取最終範圍設定。 若要擷取這些設定,請使用 GetRange GetRangeMax GetRangeMin 成員函式。

應用程式可以使用TBS_AUTOTICKS樣式自動顯示滑杆控制項的刻度標記。 不過,如果應用程式需要控制刻度標記的位置或頻率,可以使用許多成員函式。

若要設定刻度標記的位置,應用程式可以使用 SetTic 成員函式。 SetTicFreq 成員函式可讓應用程式設定在滑杆控制項範圍中定期出現的刻度標記。 例如,應用程式可以使用這個成員函式,在介於 1 到 100 的範圍內只顯示 10 個刻度標記。

若要擷取對應至刻度標記的範圍中的索引,請使用 GetTic 成員函式。 GetTicArray 成員函式會擷取這些索引的陣列。 若要擷取刻度標記的位置,請在用戶端座標中,使用 GetTicPos 成員函式。 應用程式可以使用 GetNumTics 成員函式擷取刻度 數目。

ClearTics 成員函 式會移除滑杆控制項的所有刻度標記。

滑杆控制項的線條大小會決定當應用程式收到TB_LINEDOWN或TB_LINEUP通知訊息時,滑杆移動的距離。 同樣地,頁面大小會決定對TB_PAGEDOWN和TB_PAGEUP通知訊息的回應。 應用程式可以使用 GetLineSize、SetLineSize、 GetPageSize 和 SetPageSize 成員函式來擷取和設定行和 頁面大小值 。

應用程式可以使用成員函式來擷取滑杆控制項的維度。 GetThumbRect 成員函式會擷取滑杆的周框。 GetChannelRect 成員函式會擷取滑杆控制項通道的周框。 (通道是滑杆移動的區域,且在選取範圍時包含醒目提示。

如果滑杆控制項具有TBS_ENABLESELRANGE樣式,使用者可以從中選取連續值的範圍。 許多成員函式允許動態調整選取範圍。 SetSelection 成員函式會設定選取範圍的開始和結束位置。 當使用者完成選取範圍設定時,應用程式可以使用 GetSelection 成員函式來擷取 設定 。 若要清除使用者的選取範圍,請使用 ClearSel 成員函式。

另請參閱

使用 CSliderCtrl
Controls