BDiscreteParameter

Library: libmedia.so

Allocation: Constructor only

Summary

　BDiscreteParameterクラスは、不連続な値のセットのうちの一つを設定されたパラメータを表現します。これは普通、色空間（color space）、マルチプレクサ、ミュート、enable（訳注 : 使用できるかできないかを示す値）などの非線形の値に対して使用されます。

　不連続な値はそれぞれ、nodeについてユーザインターフェイスを描画するアプリケーションによってユーザに表示される「名前」を持っています。

　デフォルトのシステムのthemeはこれらを、parameter kindに従って、BCheckBox control、BRadioButtonグループまたはBMenuField controlとして描画します。その他のthemeは、これらを異った形で実装します。

Constructor and Destructor

　BDiscreteParameterオブジェクトは、決してあなた自身が生成したり削除したりしないで下さい。その代わりに、BDiscretParameterを生成するために、あなたが望むBParameterGroupのBParameterGroup::MakeDiscreteParameter()関数を呼び出して下さい。

Member Functions

AddItem()

status_t AddItem(int32 value, const char *name)

　そのcontrolが取れる値のリストに、name / valueのペアを追加します。

RETURN CODES

B_OK. アイテムは問題なく追加された。

B_NO_MEMORY. リストにアイテムを追加するには、メモリが足りなかった。

CountItems()

int32 CountItems(void)

　controlが取ることのできる、不連続な値の数を返します。

ItemNameAt() , ItemValueAt()

const char *ItemNameAt(int32 index)

int32 ItemValueAt(int32 index)

　これらの関数は、指定されたindexのアイテムの名前と値を返します。indexの範囲は、0からCountItems()-1CountItems() - 1 までです。

選択部分の値は、必ずしも順番に並べ替えられる必要はありませんし、ユニークである必要もありません。

MakeEmpty()

void MakeEmpty(void)

Removes all items from the BDiscreteParameter.

MakeItemsFromInputs() , MakeItemsFromOutputs()

void MakeItemsFromInputs(void)

void MakeItemsFromOutputs(void)

　これらの関数は、全ての入力と出力を選択肢として追加します。入力または出力の名前がアイテム名として使用され、また入力または出力のindexがアイテムの値として使用されます。

　これらのショートカットによって、入力または出力の番号のうち一つをユーザが選択できるようにするMUX風のcontrolのためのアイテムリストを容易に生成できます。

これらの関数のうちいずれかを呼び出す際には、正しい入力及び出力がすでにパラメータに接続されていなければならないということを銘記して下さい。そうでなければ、入力及び出力がないことから、アイテムは追加されません。

ValueType()

virtual type_code ValueType(void)

　BDiscreteParameterの値が維持されているデータ型であるB_INT32_TYPEを返します。

The Media Kit Table of Contents

The Media Kit Index

The Be Book,
...in lovely HTML...
for BeOS Release 5.