uilistbox
リスト ボックス コンポーネントの作成
説明
lb = uilistboxListBox オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこの Figure を作成します。
lb = uilistbox(___,Name,Value)uilistbox("Multiselect","on") は、アプリ ユーザーが複数の項目を選択できるリスト ボックスを作成します。
例
UI Figure 内にリスト ボックスを作成します。
fig = uifigure; lb = uilistbox(fig);
UI Figure 内にリスト ボックスを作成し、リスト ボックスの項目を指定します。
fig = uifigure; lb = uilistbox(fig,"Items",["Australia","France","Germany"]);
選択されている項目の値をクエリします。
val = lb.Value
val = 'Australia'
プログラムによってリスト ボックスの選択を更新します。
lb.Value = "Germany";
UI Figure 内にリスト ボックスを作成します。アプリ ユーザーが複数の項目を選択できるようにします。
fig = uifigure; lb = uilistbox(fig,"Multiselect","on");
Ctrl キーを押したままリスト ボックス内の複数の項目をクリックして選択します。
Value プロパティは選択されているすべての項目を cell 配列として格納します。
val = lb.Value
val =
1×2 cell array
{'Item 2'} {'Item 4'}UI Figure 内にリスト ボックスを作成し、Items プロパティを設定してリスト ボックスに表示される色名のリストを指定します。
fig = uifigure; lb = uilistbox(fig,"Items",["Red","Green","Blue"]);
項目にデータが関連付けられていない場合、リスト ボックスの Value プロパティは Items の要素です。
val = lb.Value
val = 'Red'
ItemsData プロパティを設定して、16 進数の色データをリスト ボックスの項目に関連付けます。ItemsData を設定しても、項目がどのようにアプリ ユーザーに表示されるのかは変更されません。
lb.ItemsData = ["#F00","#0F0","#00F"];
ItemsData プロパティが空でない場合、リスト ボックスの Value プロパティは ItemsData の要素です。
val = lb.Value
val = "#F00"
ItemsData を指定することで、選択されている項目に関連付けられた操作を実行しやすくすることができます。たとえば、16 進数の色値を関数 plot に直接渡すことで、選択されている色でデータをプロットします。
plot(1:10,"Color",lb.Value)
ユーザーがリスト ボックスの項目を選択したときにチャートのカラーマップを更新するアプリを作成します。
colormapApp.m という名前のファイルで、アプリを実装する関数を作成します。
UI Figure およびグリッド レイアウト マネージャーを作成してアプリをレイアウトします。
グリッド レイアウト マネージャーでリスト ボックスと、データがプロットされた UI 座標軸を作成します。
UI 座標軸のカラーマップを更新する
listBoxValueChangedという名前のコールバック関数を作成し、その関数をリスト ボックスのValueChangedFcnコールバック プロパティに割り当てます。コールバックの詳細については、プログラムで作成したアプリ用のコールバックの作成を参照してください。
function colormapApp fig = uifigure; g = uigridlayout(fig,[3 2]); g.RowHeight = {'1x','fit','1x'}; g.ColumnWidth = {'fit','1x'}; lb = uilistbox(g, ... "Items",["Spring","Summer","Autumn","Winter"], ... "ItemsData",{spring,summer,autumn,winter}); lb.Layout.Row = 2; lb.Layout.Column = 1; ax = uiaxes(g); ax.Layout.Row = [1 3]; ax.Layout.Column = 2; surf(ax,peaks) colormap(ax,spring) lb.ValueChangedFcn = @(src,event) listBoxValueChanged(src,event,ax); end function listBoxValueChanged(src,event,ax) cmap = event.Value; colormap(ax,cmap) end
関数 colormapApp を実行します。リスト ボックスの項目を選択してカラーマップを変更します。
colormapApp
R2023a 以降
異なるイメージを表す 3 つの項目を含むリスト ボックスを作成します。
fig = uifigure; lb = uilistbox(fig,"Items",["Peppers","Nebula","Street"]);
リスト ボックスの項目に対応するアイコンをもつ 3 つのスタイルを作成します。
s1 = uistyle("Icon","peppers.png"); s2 = uistyle("Icon","ngc6543a.jpg"); s3 = uistyle("Icon","street1.jpg");
スタイルをリスト ボックスの項目に追加してアイコンを表示します。
addStyle(lb,s1,"item",1); addStyle(lb,s2,"item",2); addStyle(lb,s3,"item",3);
入力引数
名前と値の引数
ヒント
プログラムによりスクロールしてリスト ボックスの項目やリストの最上部または最下部を表示するには、関数 scroll を使用します。
