uieditfield
テキストまたは数値の編集フィールド コンポーネントの作成
構文
説明
ef = uieditfieldEditField オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこの Figure を作成します。
ef = uieditfield(parent)Figure オブジェクト、またはそのいずれかの子コンテナーを指定できます。
ef = uieditfield(style)"text" または "numeric" にすることができます。
ef = uieditfield(___,Name,Value)Value プロパティを使用して編集フィールド値を指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
例
UI Figure にテキスト編集フィールドを作成します。
fig = uifigure; ef = uieditfield(fig);
スタイルを "numeric" として指定して、数値編集フィールドを作成します。
fig = uifigure;
ef = uieditfield(fig,"numeric");
数値編集フィールドを作成し、その範囲を 0 ～ 100 に設定します。
fig = uifigure; ef = uieditfield(fig,"numeric", ... "Limits",[0 100]);
既定値を決定します。
val = ef.Value
val = 0
編集フィールドの値を 50 に設定します。
ef.Value = 50;
アプリ ユーザーが任意の値を入力できる一方で、必ず厳密に 2 桁の小数部と指定した単位を使用して値が表示される数値編集フィールドを作成します。編集フィールドは、アプリ ユーザーが入力したそのままの値を格納します。
fig = uifigure; ef = uieditfield(fig,"numeric", ... "ValueDisplayFormat","%.2f Volts");
数値編集フィールドに「5.5556」と入力し、その外部をクリックします。編集フィールドには 5.56 Volts が表示されます。
編集フィールドは Value プロパティの値をユーザーが入力した値 (5.5556) として格納します。編集フィールドを再びクリックすると 5.5556 が表示されます。
サポートされている書式表示演算子の詳細なリストについては、sprintfを参照してください。
-5 より大きく 10 以下の値をアプリ ユーザーが入力できる数値編集フィールドを作成します。
fig = uifigure; ef = uieditfield(fig,"numeric", ... "Limits",[-5 10], ... "LowerLimitInclusive","off", ... "UpperLimitInclusive","on", ... "Value",5);
範囲外の値を数値編集フィールドに入力すると、MATLAB はその問題を示すメッセージを表示します。無効な値を入力すると、MATLAB はその値を直前の有効な値に戻します。
長さが 3 ～ 12 文字であり、文字と数字のみで構成されるテキストをアプリ ユーザーが入力できるテキスト編集フィールドを作成します。
fig = uifigure; ef = uieditfield(fig, ... "CharacterLimits",[3 12], ... "InputType","alphanumerics");
無効な値をテキスト編集フィールドに入力すると、MATLAB はその問題を示すメッセージを表示します。その後、Enter キーを押したり、コンポーネントから移動したりすることで無効な値を入力すると、MATLAB はその値を直前の有効な値に戻します。
アプリ ユーザーが数値編集フィールドに値を入力したときにゲージの針を移動するアプリを作成します。
editFieldApp.m という名前のファイルで、アプリを実装する関数を作成します。
UI Figure およびグリッド レイアウト マネージャーを作成してアプリをレイアウトします。
グリッド レイアウト マネージャーで数値編集フィールドとゲージを作成します。
編集フィールドの値に合わせてゲージの針を更新する
editFieldValueChangedという名前のコールバック関数を作成し、その関数を編集フィールドのValueChangedFcnコールバック プロパティに割り当てます。コールバックの詳細については、プログラムで作成したアプリ用のコールバックの作成を参照してください。
function editFieldApp fig = uifigure; gl = uigridlayout(fig); gl.RowHeight = {'1x',150,'fit','1x'}; gl.ColumnWidth = {'1x',150,'1x'}; g = uigauge(gl,"Limits",[0 10]); g.Layout.Row = 2; g.Layout.Column = 2; ef = uieditfield(gl,"numeric", ... "Limits",[0 10], ... "ValueChangedFcn",@(src,event) editFieldValueChanged(src,event,g)); ef.Layout.Row = 3; ef.Layout.Column = 2; end function editFieldValueChanged(src,event,g) g.Value = src.Value; end
関数 editFieldApp を実行します。編集フィールドに値を入力して、ゲージの針を更新します。
editFieldApp
アプリ ユーザーがテキスト編集フィールドに入力した値のログを保持し、テキスト エリアにそのログを表示するアプリを作成します。
logEntriesApp.m という名前のファイルで、アプリを実装する関数を作成します。
UI Figure およびグリッド レイアウト マネージャーを作成してアプリをレイアウトします。
グリッド レイアウト マネージャーでテキスト編集フィールドとテキスト エリアを作成します。
ユーザーが編集フィールドに新しいテキストを入力するたびに前に入力されていたテキストをテキスト エリアに追加する
editFieldValueChangedという名前のコールバック関数を作成し、その関数を編集フィールドのValueChangedFcnコールバック プロパティに割り当てます。コールバック イベント データを使用して、前に入力されていたテキストにアクセスします。コールバックの詳細については、プログラムで作成したアプリ用のコールバックの作成を参照してください。
function logEntriesApp fig = uifigure; g = uigridlayout(fig); g.RowHeight = {'fit','1x'}; g.ColumnWidth = {'1x',150,'1x'}; loglist = uitextarea(g, ... "Editable","off"); loglist.Layout.Row = 2; loglist.Layout.Column = 2; ef = uieditfield(g, ... "Value","Daniela Hendrix",... "ValueChangedFcn",@(src,event) editFieldValueChanged(src,event,loglist)); ef.Layout.Row = 1; ef.Layout.Column = 2; end % Create ValueChangedFcn callback function editFieldValueChanged(src,event,loglist) prev = event.PreviousValue; loglist.Value = [prev; loglist.Value]; end
関数 logEntriesApp を実行します。編集フィールドに名前をいくつか入力します。新しい名前を入力するたびに、アプリは前の名前を、テキスト エリアに表示されているログに追加します。
