uidropdown
ドロップダウン コンポーネントを作成
説明
dd = uidropdownDropDown オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこの Figure を作成します。
dd = uidropdown(parent)Figure オブジェクト、またはそのいずれかの子コンテナーを指定できます。
dd = uidropdown(___,Name,Value)DropDown プロパティを指定します。たとえば、uidropdown("Editable","on") は、入力を有効にするドロップダウン コンポーネントを作成します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
例
既定の項目をもつドロップダウン コンポーネントを作成します。
fig = uifigure; dd = uidropdown(fig);
コンポーネントの任意の部分をクリックすると、ドロップダウン リストが開きます。
UI Figure 内に編集可能なドロップダウン コンポーネントを作成します。ユーザーはドロップダウン矢印をクリックして既存の項目から選択するか、コンポーネントをクリックして独自の値をテキストとして入力できます。
fig = uifigure; dd = uidropdown(fig,"Editable","on");
UI Figure 内にドロップダウン コンポーネントを作成し、項目を指定します。
fig = uifigure; dd = uidropdown(fig,"Items",["Red","Yellow","Blue","Green"]);
選択された項目に関連付けられている値を調べます。ItemsData プロパティが空の場合 (既定の設定)、ドロップダウン コンポーネントの Value プロパティには、選択された項目の Items プロパティに表示される名前が格納されます。
value = dd.Value
value =
'Red'ItemsData プロパティを指定して、ドロップダウン コンポーネントの個々の項目に 16 進数カラー コードを関連付けます。
dd.ItemsData = ["#F00" "#FF0" "#00F" "#0F0"];
ItemsData が空でない場合、ドロップダウン コンポーネントの Value プロパティには、選択された項目に関連付けられているデータが格納されます。
value = dd.Value
value =
"#F00"
R2023a 以降
3 つの項目を含むドロップダウン UI コンポーネントを作成します。
fig = uifigure; dd = uidropdown(fig,"Items",["Good","Fair","Poor"]);
背景色スタイルを 3 つ作成します。
s1 = uistyle("BackgroundColor","#77AC30"); s2 = uistyle("BackgroundColor","#EDB120"); s3 = uistyle("BackgroundColor","#F77A8F");
スタイルをドロップダウン コンポーネントの項目に追加して、それらの背景色を変更します。
addStyle(dd,s1,"item",1); addStyle(dd,s2,"item",2); addStyle(dd,s3,"item",3);
項目の背景色が更新され、選択された項目のスタイルがコンポーネントの外観に反映されます。このスタイルでは、ユーザーが項目をポイントしたときに表示される色は変わりません。
アプリ ユーザーがドロップダウン リストから選択するとプロットされたラインの色が変わるアプリを作成します。
plotOptions.m という名前のファイルで、アプリを実装する関数を作成します。
UI Figure およびグリッド レイアウト マネージャーを作成してアプリをレイアウトします。
グリッド レイアウト マネージャーで UI 座標軸とドロップダウン コンポーネントを作成します。
選択されたドロップダウン コンポーネントの項目に基づいてプロットの色を変更する
updatePlotという名前のコールバック関数を記述し、その関数をValueChangedFcnコールバック プロパティに割り当てます。コールバックの詳細については、プログラムで作成したアプリ用のコールバックの作成を参照してください。
function plotOptions fig = uifigure; g = uigridlayout(fig); g.RowHeight = {'1x','fit','1x'}; g.ColumnWidth = {'1x','fit'}; ax = uiaxes(g); ax.Layout.Row = [1 3]; ax.Layout.Column = 1; x = linspace(-2*pi,2*pi); y = sin(x); p = plot(ax,x,y,"Color","#F00"); dd = uidropdown(g, ... "Items",["Red","Yellow","Blue","Green"], ... "ItemsData",["#F00" "#FF0" "#00F" "#0F0"], ... "ValueChangedFcn",@(src,event) updatePlot(src,p)); dd.Layout.Row = 2; dd.Layout.Column = 2; end function updatePlot(src,p) val = src.Value; p.Color = val; end
関数 plotOptions を実行します。ドロップダウン リストから項目を選択すると、プロットの色が変わります。
plotOptions
ユーザーが表示するイメージを選択できるアプリを作成します。このアプリには編集可能なドロップダウン コンポーネントが含まれるため、ユーザーによる既存の項目の選択とユーザーによる独自の値の入力を処理するコードを記述します。
imageApp.m という名前のファイルで、アプリを実装する関数を作成します。
UI Figure およびグリッド レイアウト マネージャーを作成してアプリをレイアウトします。
グリッド レイアウト マネージャーで編集可能なドロップダウン コンポーネントとイメージ コンポーネントを作成します。
選択されたドロップダウン コンポーネントの項目に基づいてイメージを変更する
updateImageという名前のコールバック関数を記述し、その関数をValueChangedFcnコールバック プロパティに割り当てます。コールバック イベント データをクエリして、新しい値が既存の項目から選択された値であるかユーザーが入力した値であるかをチェックし、ユーザーが入力した値であれば値を検証します。コールバックの詳細については、プログラムで作成したアプリ用のコールバックの作成を参照してください。
function imageApp fig = uifigure; g = uigridlayout(fig,[2 3]); g.RowHeight = {22,'1x'}; g.ColumnWidth = {'1x','fit','1x'}; dd = uidropdown(g, ... "Editable","on", ... "Items",["peppers.png","street1.jpg"]); dd.Layout.Row = 1; dd.Layout.Column = 2; im = uiimage(g,"ImageSource","peppers.png"); im.Layout.Row = 2; im.Layout.Column = [1 3]; dd.ValueChangedFcn = @(src,event)updateImage(src,event,im,fig); end function updateImage(src,event,im,fig) val = src.Value; if event.Edited && ~exist(val,"file") im.ImageSource = ""; uialert(fig,"Enter a file on the MATLAB path","Invalid Image") else im.ImageSource = val; end end
関数 imageApp を実行し、既存の項目を選択するか独自のイメージのパスを入力してイメージを更新します。
