次の方法で共有


スライダー コントロールのメンバー関数

アプリケーションでは、スライダー コントロールのメンバー関数を呼び出して、スライダー コントロール (CSliderCtrl) に関する情報を取得したり、その特性を変更したりできます。

スライダーの位置 (つまり、ユーザーが選択した値) を取得するには、GetPos メンバー関数を使用します。 スライダーの位置を設定するには、SetPos メンバー関数を使用します。 VerifyPos メンバー関数を使用すると、スライダーが最小値と最大値の間にあることをいつでも確認できます。

スライダー コントロールの範囲は、スライダー コントロールで表すことのできる一連の連続する値です。 ほとんどのアプリケーションでは、最初の作成時に SetRange メンバー関数を使用して、スライダー コントロールの範囲を設定します。 スライダー コントロールの作成後に、SetRangeMax メンバー関数および SetRangeMin メンバー関数を使用して、範囲を動的に変更することもできます。 範囲を動的に変更できるアプリケーションでは、通常、ユーザーが最後にスライダー コントロールの操作を終了したときの範囲の設定値が取得されます。 これらの設定値を取得するには、GetRangeGetRangeMax、および GetRangeMin の各メンバー関数を使用します。

TBS_AUTOTICKS スタイルを使用すると、スライダー コントロールの目盛りを自動的に表示できます。 ただし、アプリケーションで目盛りの位置と数を制御する必要がある場合は、複数のメンバー関数を使用できます。

目盛りの位置を設定するには、SetTic メンバー関数を使用します。 SetTicFreq メンバー関数を使用すると、スライダー コントロールの範囲内に目盛りを一定の間隔で設定できます。 たとえば、アプリケーションでこのメンバー関数を使用すると、1 ~ 100 の範囲に 10 個の目盛りを表示できます。

目盛りに対応する、範囲内のインデックスを取得するには、GetTic メンバー関数を使用します。 GetTicArray メンバー関数を使用すると、これらのインデックスの配列を取得できます。 クライアント座標の目盛りの位置を取得するには、GetTicPos メンバー関数を使用します。 GetNumTics メンバー関数を使用すると、目盛りの数を取得できます。

ClearTics メンバー関数を使用すると、スライダー コントロールの目盛りをすべて削除できます。

スライダー コントロールの行サイズによって、アプリケーションが TB_LINEDOWN 通知メッセージまたは TB_LINEUP 通知メッセージを受け取るときにスライダーの移動する距離が決まります。 同様に、用紙サイズによって、TB_PAGEDOWN 通知メッセージおよび TB_PAGEUP 通知メッセージに対する応答が決まります。 アプリケーションでは、GetLineSizeSetLineSizeGetPageSize、および SetPageSize の各メンバー関数を使用して、行サイズと用紙サイズを取得または設定できます。

メンバー関数を使用して、スライダー コントロールの寸法を取得することもできます。 GetThumbRect メンバー関数を使用すると、スライダーの外接する四角形を取得できます。 GetChannelRect メンバー関数を使用すると、スライダー コントロールのチャネルの外接する四角形を取得できます。 チャネルとは、スライダーが移動する領域であり、範囲が選択されると強調表示されます。

スライダー コントロールに TBS_ENABLESELRANGE スタイルが設定されている場合、ユーザーは連続する値の範囲をスライダー コントロールから選択できます。 選択範囲は、複数のメンバー関数を使用して動的に調整できます。 SetSelection メンバー関数を使用すると、選択範囲の開始位置と終了位置を設定できます。 ユーザーによる選択範囲の設定が終了している場合は、GetSelection メンバー関数を使用して設定値を取得できます。 ユーザーの選択範囲をクリアするには、ClearSel メンバー関数を使用します。

参照

参照

CSliderCtrl の使い方

概念

コントロール (MFC)