ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

warndlg

警告ダイアログ ボックスを開く

構文

h = warndlg
h = warndlg(warningstring)
h = warndlg(warningstring,dlgname)
h = warndlg(warningstring,dlgname,createmode)

説明

h = warndlg は、文字列 This is the default warning string. を格納している Warning Dialog という名前のダイアログ ボックスを表示します。関数 warndlg は、ダイアログ ボックスのハンドルを h で返します。警告ダイアログ ボックスは、[OK] をクリックすると、消えます。

h = warndlg(warningstring) は、warningstring で指定された文字列を格納している Warning Dialog というタイトルのダイアログ ボックスを表示します。引数 warningstring は、有効な文字列の形式になります。セル配列を推奨します。

複数行の警告文を入力するには、以下のいずれかを使用して warningstring を定義します。

  • sprintf に 改行文字を使用して行を区切ります。

    warndlg(sprintf('Message line 1 \n Message line 2'))
    
  • 文字列のセル配列

    warndlg({'Message line 1';'Message line 2'})
    

h = warndlg(warningstring,dlgname) は、dlgname というタイトルをもつダイアログ ボックスを表示します。

h = warndlg(warningstring,dlgname,createmode) は、警告ダイアログ ボックスがモーダルか非モーダルかを指定します。オプションで、warningstringdlgname にインタープリターも指定できます。引数 createmode は、文字列または構造体になります。

createmode が文字列の場合、次の表に示す値のいずれかでなければなりません。

createmode の値説明
modal

指定された Title をもち、最後に作成されたかクリックされた警告ダイアログ ボックスを、指定されたモーダルな警告ダイアログ ボックスに置き換えます。同じタイトルをもつ、他のすべての警告ダイアログ ボックスは削除されます。モーダル、非モーダルのいずれのダイアログ ボックスも置き換えられます。

non-modal (既定の設定)

指定されたパラメーターをもつ新規の非モーダルな警告ダイアログ ボックスを作成します。同じタイトルをもつ、既存の警告ダイアログ ボックスは削除されません。

replace

指定された Title をもち、最後に作成されたかクリックされた警告ダイアログ ボックスを、指定された非モーダルの警告ダイアログ ボックスに置き換えます。同じタイトルをもつ、他のすべての警告ダイアログ ボックスは削除されます。モーダル、非モーダルのいずれのダイアログ ボックスも置き換えられます。

    メモ:    モーダル ダイアログ ボックスを操作する前に、ユーザーは他のウィンドウの操作ができません。MATLAB® プログラムの実行も同様にブロックするには、関数 uiwait を使用します。

    'CreateMode','modal' を使用して、関数 errordlgmsgbox、または warndlg でダイアログ ボックスを開いた場合、これらの関数のいずれかで作成された非モーダルのダイアログが既に存在し、モーダル ダイアログと同じ名前であると、モーダル ダイアログが開いたときに非モーダル ダイアログは閉じます。

    モーダル ダイアログ ボックスの詳細は、「Figure プロパティ」の「WindowStyle」を参照してください。

CreateMode が構造体の場合、WindowStyleInterpreter フィールドをもちます。WindowStyle は、上記の表に示されるオプションのいずれかでなければなりません。Interpreter は、文字列 'tex' または 'none' のいずれかです。Interpreter の既定値は、'none' です。

ステートメント

warndlg('Pressing OK will clear memory','!! Warning !!')

は、以下のダイアログ ボックスを表示します。

この情報は役に立ちましたか?