CSliderCtrl

CSliderCtrl表示滑塊控制項也稱為跟蹤條。

基本介紹

  • 中文名:類表示滑塊控制項
  • 外文名:CSliderCtrl
  • 別稱:跟蹤條
  • 控制方法:滑鼠或者箭頭鍵移動滑塊
介紹,滑塊控制項類函式簡介,操作實例,

介紹

CSliderCtrl 類表示滑塊控制項 (Slider Control),也稱為跟蹤條。滑塊控制項 (Slider Control) 是一個包含一個滑塊和可選刻度線的視窗。當用戶使用滑鼠或者箭頭鍵移動滑塊時,滑塊控制項 (Slider Control) 傳送通知訊息以指示此更改。
當希望用戶選擇一個不連續的值或者某個範圍中一組連續值時,滑塊控制項 (Slider Control) 很有用。例如,通過將滑塊移動到給定刻度線,可以使用滑塊控制項 (Slider Control) 使用戶得以設定鍵盤的重複速度。
滑塊控制項 (Slider Control) 中的滑塊以您在創建它時所指定的增量移動。例如,如果您指定滑塊控制項 (Slider Control) 的範圍為 5,則滑塊只能占有 6 個位置:一個位置在滑塊控制項 (Slider Control) 的左邊,而此範圍中的每個增量各有一個位置。通常,這些位置的每一個都用一個刻度線標識。
滑動條控制主要是用一個帶有軌道和滑標的小視窗以及視窗上的刻度,來讓用戶選擇一個離散數據或一個連續的數值區間。通過滑鼠或鍵盤來進行數據的選擇操作,這在WIN98/95中的很多應用程式中都可以看到,如控制臺中的滑鼠等,滑動條既可以是水平方式的也可以是垂直方式的。滑動條控制的風格如下:
TBS_HORZ 滑動條是水平方向的
TBS_VERT 滑動條是垂直方向的
TBS_LEFT 滑動條位於視窗左側
TBS_RIGHT 滑動條位於視窗右側
TBS_TOP 滑動條位於視窗頂部
TBS_BOTTOM 滑動條位於視窗底部
TBS_BOTH 滑動條位於視窗兩側
TBS_AUTOTICKS滑動條具有刻度,默認
TBS_NOTICKS 滑動條不具有刻度
滑動條的刻度條在每一個數值位置顯示一個刻度標記,如果在滑動條上顯示某一數值選擇區間,則應使用風格TBS_ENABLESELRANGE,此時選擇區間兩個不再是刻度標記,而是一個小的三角形符號。另外,使用風格TBS_NOTHUMB會使滑標消隱起來。
滑動條控制在MFC類庫中被封裝為CSliderCtrl控制,其主要操作是設定刻度範圍、繪製刻度標記、設定選擇範圍和當前滑標位置等。當用戶進行互動操作時,滑動條控制將向其父視窗傳送訊息WM_HSCROLL,所以在應用程式中應重載父視窗的OnHScroll()成員函式,以便對訊息進行正確處理系統傳送的通知代碼、滑標位置和指向CSliderCtrl對象的指針等。由於考慮到和水平捲動桿公用同一個成員函式,OnHScroll()函式參數表中的指針變數被定義為CScrollBar*類型,由於實際上訊息是由滑動條產生的,所以在程式中必須把這個指針變數強制轉換為CSliderCtrl*類型。滑動條和捲動桿的訊息代碼和含義都非常類似如TB_BOTTOM等,所以這種處理方法比較合理。SetRange()函式用來設定範圍,SetPos()函式用來設定當前位置。

滑塊控制項類函式簡介

CSliderCtrl::CSliderCtrl 構造函式
CSliderCtrl::Create  創建軌道條。
CSliderCtrl::GetLineSize 取得一行的大小,對應鍵盤的方向鍵。
CSliderCtrl::SetLineSize 設定一行的大小。
CSliderCtrl::GetPageSize 取得一頁的大小,對應PageUp、PageDown鍵。
CSliderCtrl::SetPageSize 設定一頁的大小。
CSliderCtrl::GetRangeMax 取得上限,就是最大值。
CSliderCtrl::GetRangeMin 取得下限,就是最小值。
CSliderCtrl::GetRange 取得上下限。
CSliderCtrl::SetRangeMin 設定最小值,bRedraw表示是否重繪。
CSliderCtrl::SetRangeMax 設定最大值,bRedraw表示是否重繪。
CSliderCtrl::SetRange 設定上下限,bRedraw表示是否重繪。
CSliderCtrl::GetSelection 取得軌道條的選擇範圍,nMin存放起始位置,nMax存放結束位置。
CSliderCtrl::SetSelection 設定軌道條的選擇範圍,此範圍會高亮顯示。
CSliderCtrl::GetChannelRect 取得Channel的範圍,Channel是溝、水道的意思。它在刻度之上,供Thumb移動的區域。
CSliderCtrl::GetThumbRect 取得“拇指”的範圍,“拇指”就是我們可以通過滑鼠拖動的那個小方塊。
CSliderCtrl::GetPos 取得軌道條的當前位置。
CSliderCtrl::SetPos 設定軌道條的當前位置。
CSliderCtrl::GetNumTics 取得刻度的數量。
CSliderCtrl::GetTicArray  取得所有刻度的位置。
CSliderCtrl::GetTic 取得第 nTic 個刻度的位置,無論此刻度是否顯示。首刻度和尾刻度由系統處理,不在此列。假定範圍是10到100,那么GetTic(0)的值是11,GetTic(1)值是12。
CSliderCtrl::GetTicPos 取得第 nTic 個刻度的物理位置,客戶區坐標。
CSliderCtrl::SetTic 在某個刻度的位置的顯示一個刻度。
CSliderCtrl::SetTicFreq 設定顯示刻度的間隔,假定範圍是0到100,SetTicFreq(20)後,會在20、40、60、80顯示刻度,加上系統的兩個刻度0、100,總共6個。
CSliderCtrl::GetBuddy 取得關聯視窗。
CSliderCtrl::SetBuddy 設定關聯視窗。
CSliderCtrl::GetToolTips 取得提示條。
CSliderCtrl::SetToolTips 設定提示條。
CSliderCtrl::SetTipSide 設定提示條的位置。
CSliderCtrl::ClearSel 清空當前選擇。
CSliderCtrl::VerifyPos 確認當前位置是否合法。
CSliderCtrl::ClearTics 清除當前刻度。

操作實例

一,新建一個基於對話框的工程SliderCtrl。
二,在主對話框上增加一個軌道條控制項,把它弄大些,選中“Tick marks”、“Enable selection”、“Auto ticks”屬性。
三,為其關聯一個CSliderCtrl類型的變數m_slider。
四,在主對話框的初化函式中加如下代碼:
BOOLCSliderCtrlDlg::OnInitDialog(){//...m_slider.SetRange(0,100);m_slider.SetPageSize(10);m_slider.SetLineSize(1);returnTRUE;//returnTRUEunlessyousetthefocustoacontrol}
五,增加兩個按鈕,回響函式如下:
voidCSliderCtrlDlg::OnButton1(){intiPos=m_slider.GetPos();CStringstrMess;strMess.Format("你輸入的分數是%d\n",iPos);AfxMessageBox(strMess);}voidCSliderCtrlDlg::OnButton2(){//設定每10個刻度顯示一個間隔m_slider.SetTicFreq(10);//在75處增加一個刻度線m_slider.SetTic(75);//高亮顯示60-79m_slider.SetSelection(60,79);m_slider.Invalidate();m_slider.UpdateWindow();}
(二)滑動條控制的對象結構
滑動條控制的建立方法
CsliderCtrl &SliderCtrl 建立滑動條控制對象結構
Create 建立滑動條控制對象並綁定對象
滑動條控制類CSliderCtrl::Create的調用格式如下:
BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );
其中參數dwStyle用來確定滑動條控制風格;參數rect用來確定滑動條控制的大小和位置;參數pParentWnd用來確定滑動條控制的父視窗指針;參數nID用來確定滑動條控制的控制符ID值。
2、滑動條控制的類屬性
滑動條控制對象的類屬性包括
取得滑動條大小GetLineSize
設定滑動條大小SetLineSize
取得滑動條頁大小GetPageSize
設定滑動條頁大小SetPageSize
取得滑動條最大位置GetRangeMax
取得滑動條最小位置GetRangeMin
取得滑動條範圍GetRange
設定滑塊最小位置SetRangeMin
設定滑塊最大位置SetRangeMax
設定滑動條範圍SetRange
取得滑塊當前位置GetSelection
設定滑塊當前位置SetSelection
取得滑動條當前位置GetPos
設定滑動條當前位置SetPos
3、滑動條控制的操作方法
滑動條控制的操作方法包括清除滑動條當前選擇ClearSel、驗證滑動條當前位置是否在最大最小位置之間VerifyPos和清除當前刻度標誌ClearTics。
滑動條控制的套用技巧示例
1、利用應用程式嚮導AppWizard生成基於對象框的應用程式CSlidDlg;
2、在對話框中設定滑動條控制,其ID為IDC_SLIDER;
3、在對話框初始代碼中增加控制的範圍和位置:
(1)在SlidDlg.h中設定數據成員,用來表示滑動條的當前值:
//SlidDlg.hclassCSlidDlg:publicCdialog{//其它代碼public:intm_nCur;//其它代碼}
(2)在SlidDlg.cpp中設定初始狀態
BOOLCSlidDlg::OnInitDialog(){Cdialog::OnInitDialog();//其它代碼CSliderCtrl*pSlidCtrl=(CSliderCtrl*)GetDlgItem(IDC_SLLIDER);pSlidCtrl->SetRange(1,5,TRUE);//設定滑動條範圍pSlidCtrl->SetPos(2);//設定滑動條位置//其它代碼returnTRUE;}
(3)完善滑動條的訊息處理,利用類嚮導ClassWizard增加對話框視窗的WM_HSCROLL訊息處理函式,並取得滑標所指位置值:
voidCSlidDlg::OnHScroll(UINTnSBCode,UINTnPos,CScrollBar*pScrollBar){Cdialog::OnHScroll(nSBCode,nPos,pScrollBar);CSliderCtrl*pSlidCtrl=(CSliderCtrl*)GetDlgItem(IDC_SLLIDER);m_nCur=pSlidCtrl->GetPos();//取得當前位置值}

相關詞條

熱門詞條

聯絡我們