値。ItemsまたはItemsDataの配列の要素として指定します。既定では、ValueはItemsの最初の要素になります。

ValueをItemsの要素として指定すると、その要素に一致するドロップダウン項目が選択されます。ItemsDataが空でない場合,ValueはItemsDataの要素に設定しなければならず、ドロップダウンでリスト内の関連する項目が選択されます。

Editableが'on'に設定されている場合、Valueを文字ベクトルまたは string スカラーとして追加で指定できます。

プレースホルダー テキスト。文字ベクトルまたは string スカラーとして指定します。プレースホルダーは、ドロップダウン項目の簡単な説明を提供します。プレースホルダー テキストが表示されるのは、ドロップダウンに''が表示される場合のみです。これは、以下の 2 つの状況で行われます。

たとえば、ItemsDataのないドロップダウンにプレースホルダーを表示するには、''をItemsに追加してValueプロパティを''に設定します。

fig = uifigure('Position',[100 100 300 200]); dd = uidropdown(fig,'Items',{'','One','Two'},...'Value','',...'Placeholder','Options');

ドロップダウン項目。文字ベクトルの cell 配列、string 配列、または 1 次元の categorical 配列として指定します。重複する要素を使用できます。ドロップダウン コンポーネントにはItemsの配列の要素数と同数のオプションが表示されます。このプロパティを categorical 配列として指定した場合、MATLAB^®はカテゴリの完全なセットではなく、配列内の値を使用します。

例:{“红”、“黄”、“Blue'}

例:{'1','2','3'}

Itemsプロパティ値の各要素に関連付けるデータ。1 行 n 列の数値配列または 1 行 n 列の cell 配列として指定します。重複する要素を使用できます。

たとえば、Items値を従業員の氏名に設定した場合、ItemsData値を対応する従業員の ID 番号に設定できます。ItemsData値はアプリ ユーザーに表示されません。

ItemsData値とItems値の配列要素数が一致しない場合、次のいずれかが起こります。

例:{'One','Two','Three'}

例:[10 20 30 40]

フォント名。システムでサポートされているフォント名として指定します。既定のフォントは、特定のオペレーティング システムとロケールによって異なります。

指定したフォントが利用できない場合、MATLAB は、アプリが実行中のシステムで利用可能なフォントから最もよく一致するフォントを使用します。

例:'Arial'

フォント サイズ。正の数値として指定します。測定単位はピクセルです。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。

例:14

フォントの太さ。次のいずれかの値として指定します。

すべてのフォントに太字フォントがあるとは限りません。太字がないフォントの場合、'bold'を指定すると標準フォントの太さになります。

フォントの角度。“正常”または'italic'として指定します。すべてのフォントにイタリックのフォントの角度があるわけではありません。イタリックがないフォントの場合、'italic'を指定すると標準フォントの角度になります。

フォントの色。RGB 3 成分、16 進数カラー コードまたは表にリストされたオプションのいずれかとして指定します。

RGB 3 成分および 16 進数カラー コードは、カスタム色を指定するのに役立ちます。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

背景色。RGB 3 成分、16 進数カラー コード、または表にリストされた色オプションのいずれかとして指定します。

RGB 3 成分および 16 進数カラー コードは、カスタム色を指定するのに役立ちます。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

可視性の状態。'on'または'off'、もしくは数値または logical1(true) または0(false) として指定します。'on'の値はtrueと等価であり、'off'はfalseと等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState型の on/off logical 値として格納されます。

アプリの起動を高速化するには、起動時に表示する必要のないすべての UI コンポーネントのVisibleプロパティを'off'に設定します。

ドロップダウン コンポーネントの編集可否の状態。'off'または'on'、もしくは数値または logical1(true) または0(false) として指定します。'on'の値はtrueと等価であり、'off'はfalseと等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState型の on/off logical 値として格納されます。

Enableプロパティ値が'off'である場合、編集可否のプロパティ値が'on'でもアプリ ユーザーはドロップダウン コンポーネントのテキストを変更できません。

操作可能状態。'on'または'off'、もしくは数値または logical1(true) または0(false) として指定します。'on'の値はtrueと等価であり、'off'はfalseと等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState型の on/off logical 値として格納されます。

ツールヒント。文字ベクトル、文字ベクトルの cell 配列、string 配列、または 1 次元の categorical 配列として指定します。このプロパティを使用して、実行時にユーザーがポインターをコンポーネントに合わせるとメッセージが表示されるようにします。コンポーネントが無効になっている場合でも、ツールヒントは表示されます。複数行のテキストを表示するには、文字ベクトルの cell 配列または string 配列を指定します。配列の各要素は、テキストの各行になります。このプロパティを categorical 配列として指定した場合、MATLAB はカテゴリの完全なセットではなく、配列内の値を使用します。

コンテキスト メニュー。関数uicontextmenuを使用して作成されたContextMenuオブジェクトとして指定します。このプロパティは、コンポーネントを右クリックしたときにコンテキスト メニューを表示するために使用します。

親を基準にしたドロップダウン コンポーネントの位置とサイズ。ベクトル[left bottom width height]として指定します。次の表で、ベクトルの各要素について説明します。

すべての測定単位はピクセルです。

Positionの値の基準は、親コンテナーの"描画可能領域"です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。

例:[100 100 100 22]

ドロップダウン コンポーネントの内側の位置とサイズ。[left bottom width height]として指定します。位置の値の基準は親コンテナーです。すべての測定単位はピクセルです。このプロパティ値は、ドロップダウン コンポーネントのPositionと同一です。

このプロパティは読み取り専用です。

ドロップダウン コンポーネントの外側の位置とサイズ。[left bottom width height]として返されます。位置の値の基準は親コンテナーです。すべての測定単位はピクセルです。このプロパティ値は、ドロップダウン コンポーネントのPositionと同一です。

レイアウト オプション。GridLayoutOptionsオブジェクトとして指定します。このプロパティは、グリッド レイアウト コンテナーの子であるコンポーネントのオプションを指定します。コンポーネントがグリッド レイアウト コンテナーの子ではない場合 (たとえば、Figure またはパネルの子である場合) は、このプロパティは空で、効果はありません。しかし、コンポーネントがグリッド レイアウト コンテナーの子である場合は、GridLayoutOptionsオブジェクトのRowプロパティおよびColumnプロパティを設定して、グリッドの目的の行と列にコンポーネントを配置することができます。

たとえば、以下のコードは、ドロップダウンをその親グリッドの 3 行目の 2 列目に配置します。

g = uigridlayout([4 3]); dd = uidropdown(g); dd.Layout.Row = 3; dd.Layout.Column = 2;

ドロップダウンが複数の行または列にまたがるようにするには、RowまたはColumnプロパティを 2 要素ベクトルとして指定します。たとえば、次のドロップダウンは2列目から3列目にまたがります。

dd.Layout.Column = [2 3];

値が変更されたときのコールバック。次の値のいずれかとして指定します。

このコールバック関数は、ドロップダウン リストから別のオプションを選択するときに実行されます。Valueプロパティがプログラムにより変更される場合には実行されません。

このコールバック関数は、ユーザーのドロップダウン操作に関する特定の情報にアクセスできます。MATLAB は、この情報をValueChangedDataオブジェクトに格納して、2 番目の引数としてコールバック関数に渡します。App Designer では、引数はeventと呼ばれます。ドット表記を使用して、オブジェクトのプロパティをクエリできます。たとえば、event.PreviousValueはドロップダウンの直前の値を返します。ValueChangedDataオブジェクトは、文字ベクトルとして指定されているコールバック関数では使用できません。

次の表に、ValueChangedDataオブジェクトのプロパティを示します。

コールバックの記述の詳細については、App Designer でコールバックを記述するを参照してください。

ドロップダウン メニューを開くコールバック関数。次の値のいずれかとして指定します。

このプロパティは、ユーザーがクリックしてドロップダウン メニューを開いたときに実行するコールバック関数を指定します。このコールバックの使用方法として、ドロップダウン メニューのエントリのリストの動的な更新があります。

このコールバック関数は、ユーザーのドロップダウン操作に関する特定の情報にアクセスできます。MATLAB は、この情報をDropDownOpeningDataオブジェクトに格納して、2 番目の引数としてコールバック関数に渡します。App Designer では、引数はeventと呼ばれます。ドット表記を使用して、オブジェクトのプロパティをクエリできます。たとえば、event.Sourceは、ユーザーの操作に応じてコールバックをトリガーするDropDownオブジェクトを返します。DropDownOpeningDataオブジェクトは、文字ベクトルとして指定されているコールバック関数では使用できません。

次の表に、DropDownOpeningDataオブジェクトのプロパティを示します。

コールバックの記述の詳細については、App Designer でコールバックを記述するを参照してください。

オブジェクト作成関数。次の値のいずれかとして指定します。

コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、App Designer でコールバックを記述するを参照してください。

このプロパティは、MATLAB がオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLAB はCreateFcnコールバックを実行する前に、すべてのプロパティ値を初期化します。CreateFcnプロパティを指定しない場合、MATLAB は既定の作成関数を実行します。

既存のコンポーネントにCreateFcnプロパティを設定しても効果はありません。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、作成中のオブジェクトにアクセスできます。それ以外の場合は、関数gcboを使用してオブジェクトにアクセスします。

オブジェクト削除関数。次の値のいずれかとして指定します。

コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、App Designer でコールバックを記述するを参照してください。

このプロパティは、MATLAB がオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLAB は、オブジェクトのプロパティを破棄する前にDeleteFcnコールバックを実行します。DeleteFcnプロパティを指定しない場合,MATLABは既定の削除関数を実行します。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、削除されるオブジェクトにアクセスできます。それ以外の場合は、関数gcboを使用してオブジェクトにアクセスします。

コールバックの割り込み。'on'または'off'、もしくは数値または logical1(true) または0(false) として指定します。'on'の値はtrueと等価であり、'off'はfalseと等価です。したがって、このプロパティの値を logical 値として使用できます。値はmatlab.lang.OnOffSwitchState型の on/off logical 値として格納されます。

このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。次の 2 つのコールバックの状態について考慮する必要があります。

MATLAB は、コールバック キューを処理するコマンドを実行するたびにコールバックの割り込み動作を判別します。これらのコマンドには、drawnow、figure、uifigure、getframe、waitfor、pauseがあります。

実行中コールバックにこれらのコマンドが含まれていない場合、割り込みは発生しません。MATLAB は、実行中コールバックの実行を先に終了させ、その後に割り込みコールバックを実行します。

実行中コールバックにこれらのいずれかのコマンドが含まれている場合、実行中コールバックを所有するオブジェクトのInterruptibleプロパティに応じて割り込みが発生するかどうかが決まります。

コールバック キューイング。'queue'または'cancel'として指定します。BusyActionプロパティは MATLAB による割り込みコールバックの実行の処理方法を決定します。次の 2 つのコールバックの状態について考慮する必要があります。

BusyActionプロパティによってコールバック キューイングの動作が決まるのは、次の両方の条件を満たす場合のみです。

これらの条件に当てはまる場合、割り込みコールバックを所有するオブジェクトのBusyActionプロパティに応じて MATLAB による割り込みコールバックの処理方法が決まります。BusyActionプロパティは次の値を取ることができます。

このプロパティは読み取り専用です。

削除状態。matlab.lang.OnOffSwitchState型の on/off logical 値として返されます。

MATLAB は、DeleteFcnコールバックが実行を開始すると、BeingDeletedプロパティを'on'に設定します。コンポーネント オブジェクトが存在しなくなるまでBeingDeletedプロパティは'on'に設定されたままです。

クエリや変更の前にオブジェクトが削除されようとしていないか確認するためにBeingDeletedプロパティの値をチェックします。

親コンテナー。関数uifigureを使用して作成されたFigureオブジェクト、またはその子コンテナー (Tab、Panel、ButtonGroupまたはGridLayout) のいずれかとして指定します。コンテナーが指定されていない場合、MATLAB は関数uifigureを呼び出し、親コンテナーとして使用される新しいFigureオブジェクトを作成します。

オブジェクト ハンドルの可視性。'on'、'callback'または'off'として指定します。

このプロパティは、オブジェクトの親がもつ子のリストにおけるそのオブジェクトの可視性を制御します。オブジェクトがその親オブジェクトのリストで、子として可視できない場合、オブジェクト階層の検索またはプロパティのクエリによってオブジェクトを取得する関数は、そのオブジェクトを返しません。これらの関数には、get、findobj、clfおよびcloseが含まれます。オブジェクトは参照できない場合も有効です。オブジェクトにアクセスできる場合は、そのプロパティを設定および取得して、それをオブジェクトに作用する任意の関数に渡すことができます。

このプロパティは読み取り専用です。

グラフィックス オブジェクトのタイプ。'uidropdown'として返されます。

オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。オブジェクトの識別子として機能する一意のTag値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合、関数findobjを使用してTag値に基づいてオブジェクトを検索できます。

ユーザー データ。任意の MATLAB 配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。

App Designer を使用している場合は、UserDataプロパティを使用する代わりに、アプリでパブリック プロパティまたはプライベート プロパティを作成してデータを共有します。詳細については、App Designer アプリ内でのデータの共有を参照してください。