スライダ付き数値編集ボックス

標準の数値コントロールには、数値編集ボックスおよびオプションのスライダと一緒に、オプションのアニメーションアイコン、およびオプションのラベルが表示されます。これらは、任意の数値型の基本パラメータに関連付けられています。

ヒント:

スライダに対して有効な値範囲を指定するには、パラメータを作成するときに、Parameter.Min または Parameter::GetMin および Parameter.Max または Parameter::GetMax プロパティを使用します。

これらを作成するには、PPGLayout.AddItem または PPGLayout::AddItem メソッド(siControlNumber は数値パラメータのデフォルトです)を使用します。

var oItem = oLayout.AddItem( "Girth", "", siControlNumber );

次に、ファイルブラウザウィジットの機能のいくつかについて、設定方法のヒントを示します。

注:

レイアウトの番号を設定するフルレンジのセンスを取得するには、Number Control 例(PPGLayout オブジェクトのための)をチェックアウトします。

使用可能な項目属性は次のとおりです。

すべてのコントロールで(また、PPGItem オブジェクトのプロパティとしても)使用可能な属性	多くのコントロールに共通の属性	標準の数値コントロールに固有の属性
siUILabel siUIItems siUIType siUIWidthPercentage siUILabelPercentage siUILabelMinPixels	siUINoLabel siUIValueOnly siUIContinue siUICX siUICY	siUISyncSlider siUILogarithmic siUIDecimals siUINoSlider siUIThumbWheel siUITreadmill

スライダの外観をカスタマイズするには

デフォルトのスライダを変更するための属性が多数あります。

siUINoSlider: 数値のみを入力する入力ボックス(スライダなし)
siUIThumbWheel: デフォルトスライダの小さいバージョン
siUITreadmill: ThumbWheel と同じサイズですが、左右にスクラブすることによって値を変更します。つまり、スライド内をクリックしても値は変更されません。

// use the thumbwheel
oItem.SetAttribute( siUIThumbWheel, true );

// use the treadmill
oItem.SetAttribute( siUITreadmill, true );

// skip the slider entirely
oItem.SetAttribute( siUINoSlider, true );

コントロールの小数桁数を設定するには

siUIDecimals 属性では、数値編集ボックスに表示される小数桁数を指定できます。

oItem.SetAttribute( siUIDecimals, 1 );

この属性は基本パラメータの精度は変更しません。ただし、ユーザが UI から値を変更した場合、新しい値にはこのコントロールで設定した精度が適用されます。たとえば、小数桁数が 0 のスライダを設定した場合、ユーザが数値編集ボックスに「2.5」と入力しても、新しいパラメータ値は依然として 3 になります。

スライダに対数のスケーリングを使用するには

siUILogarithmic 属性を true に設定して、スライダのスケーリング形式をリニア(加算値)から対数(乗算値)に変更します。

oItem.SetAttribute( siUILogarithmic, true );