export2wsdlg
変数をワークスペースにエクスポートするためのダイアログ ボックスの作成
構文
説明
export2wsdlg( は、一連のチェック ボックスおよび編集フィールドをもつモーダル ダイアログ ボックスを作成します。各チェック ボックスには、対応する編集フィールドがあります。引数は、次のようになります。labels,vars,vals)
labels– チェック ボックスのラベル。ラベルの数によって、ダイアログ ボックスに表示されるチェック ボックスと編集フィールドの数が決まります。各チェック ボックスのラベルの後に 1 つの編集フィールドが表示されます。例を示します。
vars– 前のイメージに示すsumAのように、編集フィールドに表示される既定の変数名。vals– 変数に格納する値。
labels、vars および vals は同じ項目数を指定しなければなりません。labels、vars および vals がそれぞれ 1 つの項目を指定した場合、そのダイアログ ボックスには 1 つのラベルと 1 つの編集フィールドのみが表示されます。以下に例を示します。
は、ダイアログ ボックスが表示される f = export2wsdlg(___)Figure オブジェクトを f に返します。この出力は、前述の構文に示した任意の入力引数の組み合わせを使用して要求できます。
例
変数 sumA または meanA のいずれか、あるいは両方をベース ワークスペースに保存できるダイアログ ボックスを作成します。
A = randn(10,1);
labels = {'Save sum of A to variable named:' ...
'Save mean of A to variable named:'};
vars = {'sumA','meanA'};
values = {sum(A),mean(A)};
export2wsdlg(labels,vars,values);
ユーザーが 2 などの無効な変数名を入力して [OK] をクリックすると、MATLAB は自動的にエラー ダイアログ ボックスを返します。ユーザーはエラー ダイアログ ボックスの [OK] をクリックした後に、[ワークスペースにエクスポート] ダイアログ ボックスに有効な変数を入力することができます。
入力変数 defs を定義して、ダイアログ ボックスが開いたときのすべてのチェック ボックスをオフに指定します。
A = randn(10,1);
labels = {'Save sum of A to variable named:' ...
'Save mean of A to variable named:'};
vars = {'sumA','meanA'};
vals = {sum(A),mean(A)};
title = ('Save Sums to Workspace');
defs = logical([0 0]);
export2wsdlg(labels,vars,vals,...
title,defs);
すべてのチェック ボックスがオフのときにユーザーが [OK] をクリックした場合、MATLAB は自動的にエラー ダイアログ ボックスを返します。ユーザーはエラー ダイアログ ボックスの [OK] をクリックした後に、[ワークスペースにエクスポート] ダイアログ ボックスでエラーを修正することができます。
コールバックの入力引数を指定して、[ヘルプ] ボタンをダイアログ ボックスに追加します。[ヘルプ] ボタンをクリックすると、コールバックが実行されます。このコードのコールバック関数は smhelp で、ヘルプ ダイアログ ボックスを作成します。詳細については、プログラムで作成したアプリ用のコールバックの作成を参照してください。
function expsm A = randn(10,1); labels = {'Save sum of A to variable named:' ... 'Save mean of A to variable named:'}; vars = {'sumA','meanA'}; vals = {sum(A),mean(A)}; title = ('Save Sums to Workspace'); defs = logical([1 0]); export2wsdlg(labels,vars,vals,... title,defs,{@smhelp}); function smhelp helpdlg({'Select one or both check boxes.',... 'Change the variable names, if desired,',... 'and then click OK.'}); end end
この例を実行するには、上記のコードをコピーしてテキスト エディターに貼り付けます。MATLAB パス上のフォルダーにこのファイルを exspm.m として保存します。コードを実行して [ヘルプ] ボタンをクリックすると、[Save Sums to Workspace] ダイアログ ボックスより前面にヘルプ ダイアログ ボックスが開きます。次の図に、これらの 2 つのダイアログ ボックスを並べて示します。
figure オブジェクトを作成してワークスペースにエクスポートするためのダイアログ ボックスを作成します。ユーザーが該当するチェック ボックスをオンにして [OK] をクリックしたときに、指定した色で Figure ウィンドウを作成する関数リストを指定します。入力引数 vals は単なる構文プレースホルダーです。そのため、vals の値で指定された cell 配列の項目は使用されません。
labels = {'Red Figure Window',...
'Blue Figure Window',...
'Green Figure Window'};
vars = {'fRed','fBlue','fGreen'};
vals = {0,0,0};
title = 'Figure Color Samples';
defs = [false false false];
flist = {{@figure,'color','r'},...
{@figure,'color','b'},...
{@figure,'color','g'}};
export2wsdlg(labels,vars,vals,title,defs,{@doc,'figure'},flist);
ユーザーがチェック ボックスをオンにして [OK] をクリックした後に、MATLAB はオンになっているチェック ボックスについて以下を実行します。
対応する関数を実行する (各関数が Figure を作成する)。
figure オブジェクトを変数
varsに返す。変数をベース ワークスペースにエクスポートする。
入力引数
出力引数
詳細
ヒント
MATLAB プログラムの実行は、モーダルの [ワークスペースにエクスポート] ダイアログ ボックスがアクティブであっても続行されます。ユーザーがダイアログ ボックスを閉じるまでプログラムの実行をブロックする場合は、関数
uiwaitを使用します。
バージョン履歴
R2006b で導入
