スライダー コントロールのメンバー関数
アプリケーションでは、スライダー コントロールのメンバー関数を呼び出して、スライダー コントロール (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 メンバー関数を使用します。