プログラム言語 FreeBasic |
MessBox
Windows のみ:
MessBox(Caption,message,[flag=MB_OK])
Function MsgBox(ByRef Caption As String, ByRef Message As String, ByVal flag As Integer=0,ByVal ParentWin as Hwnd = 0) As Integer
Windows と Linux:
Function MessBox(ByRef Caption As String, ByRef Message As String, ByVal flag As Integer=0,ByVal ParentWin as Hwnd = 0) As Integer
普通のメッセージ・ボックスです。知らない人はいないでしょうが、メッセージを表示するダイアログ・ボックスです。
Windows および Linux の場合、MB_YESNO および MB_YESNOCANCEL フラグの戻り値は、IDYES 定数に対応します（[はい]ボタンのクリック）。IDNO（[いいえ]ボタンのクリック）; IDCANCEL（[キャンセル]ボタンのクリック）。他のすべての戻り値は Windows 専用に定義されています。
Caption - ダイアログのキャプションのテキスト
Message - メッセージテキスト
flag - 下記参照
ParentWin -
親ウィンドウのハンドル。Linux で GTK3 サブシステムを使って親ウィンドウを指定しない場合、ターミナルに警告が表示されます。
この警告はプログラムに問題を引き起こさないため、ユーザーに迷惑をかけない場合は、ParentWin パラメーターを省略できます。
Windows , Linux
例:
#Include "window9.bi"
MessBox("メッセージ","エラー")
flag:
For Windows と Linux:
MB_OK - ウィンドウのメッセージは、「OK」コマンド・ボタンを表示します。 これがデフォルトです。
MB_YESNO - メッセージボックスに、「はい」「いいえ」の、2つのコマンド・ボタンを表示します。
MB_YESNOCANCEL - メッセージボックスには、「はい」「いいえ」「中止（キャンセル）」の、3つのコマンドボタンを表示します。
Windows のみ:
MB_ABORTRETRYIGNORE - メッセージボックスに、3つのコマンド・ボタンを表示します。「中止」、「再試行」、「無視」。
MB_OKCANCEL - メッセージボックスには、「OK」と「中止」の、2つのコマンドボタンを表示します。
MB_RETRYCANCEL - メッセージボックスには、「再試行」と「中止（キャンセル）」の、2つのコマンドボタンを表示します。
メッセージ・ウィンドウにアイコンを表示するには、次のフラグのいずれかを指定します:
MB_ICONEXCLAMATION, MB_ICONWARNING - メッセージボックスのアイコンには、感嘆符が表示されます。
MB_ICONINFORMATION, MB_ICONASTERISK - メッセージボックスには、情報アイコン(丸の中に小文字のシンボルI)が、表示されます。
MB_ICONQUESTION - メッセージボックスのアイコンには、疑問符の形が表示されます。
MB_ICONSTOP,MB_ICONERROR,MB_ICONHAND - メッセージボックスのアイコンには、停止信号の形が表示されます。
デフォルトボタンを指定するには、次のフラグのいずれかを指定します:
MB_DEFBUTTON1 - 優先ボタンは、[スタート]ボタン。MB_DEFBUTTON1 は、MB_DEFBUTTON2、MB_DEFBUTTON3、MB_DEFBUTTON4 を指定しない場合のデフォルト値です。
MB_DEFBUTTON2 - 2番目のボタンが優先ボタン。
MB_DEFBUTTON3 - 3番目のボタンが優先ボタン。
MB_DEFBUTTON4 - 4番目のボタンが優先ボタン。
ダイアログボックスのモダリティを示すために、以下のフラグのいずれかを指定します:
MB_APPLMODAL - ユーザーは、hWndパラメーターで識別されるウィンドウで作業を続行する前に、メッセージボックスに応答する必要があります。
ただし、ユーザーは他のアプリケーションウィンドウに移動して作業することができます。
アプリケーションのウィンドウ階層によっては、ユーザーがアプリケーション内の他のウィンドウに移動できる場合があります。
メッセージボックスの親のすべての子ウィンドウは自動的にブロックされますが、ポップアップウィンドウはブロックされません。
MB_SYSTEMMODAL も MB_TASKMODAL も指定されていない場合、MB_APPLMODAL がデフォルトです。
MB_SYSTEMMODAL - メッセージボックスが WS_EX_TOPMOST スタイルを持っていること以外は、MB_APPLMODAL と同じです。
システムを使用して - モーダルメッセージボックスは、即時の注意（たとえば、メモリ不足の条件の下でプログラムを実行する）を必要とする深刻な、潜在的に危険なエラーを、ユーザーに通知します。
このフラグは、hWnd に関連付けられているものよりも、ユーザーが他のウィンドウと対話する能力に影響を与えません。
MB_TASKMODAL - hWnd パラメータが、NULL に設定されている場合、現在のタスクに属するすべてのトップレベル・ウィンドウが無効になっているという事実を除いて、MB_APPLMODAL と同じです。
このオプションは、
呼び出し元のアプリケーションまたはライブラリが利用可能なウィンドウハンドルを持っていないが、それでも他のアプリケーションを中断することなく、現在のソフトウェアアプリケーションの他のウィンドウへの入力データを保存する必要があるときに、使用します。
さらに、以下に示すフラグを設定することができます:
MB_DEFAULT_DESKTOP_ONLY
デスクトップは、現在の入力を受信している、デフォルトのデスクトップでなければならず、そうでなければ、関数は失敗します。
デフォルトのデスクトップとは、ユーザーがログオンした後の、最初に起動したアプリケーションのことです。
MB_HELP
メッセージウィンドウに、[ヘルプ]ボタンを追加します。 [ヘルプ]ボタンを選択するか、F1キーを押すと、ヘルプイベントを発生させます。
MB_RIGHT
右側にテキストを揃えます。
MB_RTLREADING
画面メッセージを表示しません。タイトル文字は、ユダヤ語とアラブ語のライティングシステムのための、ミラーリングが使われます。
MB_SETFOREGROUND
メッセージボックスは、優先画面になります。Windowsのメッセージボックスの中に、SetForegroundWindow（）を呼び出します。
MB_TOPMOST
メッセージボックスが、WS_EX_TOPMOST ウィンドウのスタイルで作成されます。
MB_SERVICE_NOTIFICATION
Windows NT のみ: 呼び出し元は、イベントについてユーザに通知するサービスを提供しています。 関数はユーザーがコンピュータにログオンされていない場合でも、現在アクティブなデスクトップにメッセージボックスが表示されます。
このフラグが設定されている場合は、hWnd パラメータには NULL に設定する必要があります。
これは、Wnd に対応しているだけでなく、別のデスクトップに表示されることがあるメッセージボックスです。
Windows NT version 4.0 の場合
は、MB_SERVICE_NOTIFICATION の値が変更されました。
古い値と新しい値のためにWinuser.hを参照してください。
Windows NT 4.0では、MessageBox と MessageBoxEx の実装で、古い値を新しい値にデータ変換して、既存のサービスの下位互換性を提供します。
このデータ変換は、4.0未満としてリンカによって決定されるバージョン番号を持つ、実行可能プログラム（EXEファイル）のために行われます。