dialog（ダイアログ）

システムダイアログ機能を抜け出します。開く、ファイルを保存する、プロンプト、アラートなどが含まれます。

前へcontextMenu（コンテキストメニュー）次へclipboard（クリップボード）

最終更新 2 年前

dialog（ダイアログ）

システムダイアログ機能を抜け出します。開く、ファイルを保存する、プロンプト、アラートなどが含まれます。

以下は、複数のファイルを選択するダイアログの例です：

let result = await eagle.dialog.showOpenDialog({ 
    properties: ['openFile', 'multiSelections'] 
});

メソッド

showOpenDialog(options)

ファイルを開くダイアログを表示します。

options Object
- title string (オプション) - ダイアログウィンドウのタイトル
- defaultPath string (オプション) - ダイアログのデフォルト表示パス
- buttonLabel string (オプション) - 「確認」ボタンのカスタムラベル。空の場合、デフォルトのラベルが使用されます。
- filters [] (オプション)
  - name string
  - extensions string[]
- properties string[] (オプション) - ダイアログ関連の属性が含まれます。以下の属性値がサポートされています。
  - openFile - ファイルの選択を許可
  - openDirectory - ディレクトリの選択を許可
  - multiSelections- 複数選択を許可。
  - showHiddenFiles- システムダイアログで隠しファイルが表示されるようにします。
  - createDirectory macOS - ダイアログを介して新しいディレクトリを作成できます。
  - promptToCreate Windows- ダイアログ内で入力されたファイルパスが存在しない場合、作成するように求める。これは実際にパス上にファイルを作成するわけではなく、存在しないアドレスを返すことを許可する
- message string (オプション) macOS - 入力ボックスの上部に表示されるメッセージ。
返り値 Promise<result: Object>
- resultObject
  - canceled boolean - ダイアログがキャンセルされたかどうか
  - filePaths string[] - 選択されたファイルパスの配列。ダイアログがキャンセルされた場合、空の配列になります。

{
  filters: [
    { name: 'Images', extensions: ['jpg', 'png', 'gif'] },
    { name: 'Movies', extensions: ['mkv', 'avi', 'mp4'] },
    { name: 'Custom File Type', extensions: ['as'] },
    { name: 'All Files', extensions: ['*'] }
  ]
}

let result = await eagle.dialog.showOpenDialog({
    properties: ['openFile', 'openDirectory']
});

showSaveDialog(options)

ファイル保存ダイアログを表示します。

options オブジェクト
- title string（オプション） - ダイアログウィンドウのタイトル
- defaultPath string（オプション） - ダイアログのデフォルト表示パス
- buttonLabel string（オプション） - 「確認」ボタンのカスタムラベル。空の場合、デフォルトのラベルが使用されます。
- - name string
  - extensions string[]
- properties string[] (オプション) - ダイアログに関連する属性を含む。次の属性値がサポートされています:
  - openDirectory - フォルダを選択できるようにする
  - showHiddenFiles- ダイアログに隠しファイルを表示する
  - createDirectory macOS - ダイアログを通じて新しいディレクトリを作成できるようにする
返り値 Promise<result: Object>
- result オブジェクト
  - canceled boolean - ダイアログがキャンセルされたかどうか
  - filePath string - ダイアログがキャンセルされた場合、この値は undefined になります。

{
  filters: [
    { name: 'Images', extensions: ['jpg', 'png', 'gif'] },
    { name: 'Movies', extensions: ['mkv', 'avi', 'mp4'] },
    { name: 'Custom File Type', extensions: ['as'] },
    { name: 'All Files', extensions: ['*'] }
  ]
}

let result = await eagle.dialog.showSaveDialog({
    properties: ['openDirectory']
});

showMessageBox(options)

メッセージダイアログを表示。

optionsオブジェクト
- message string - ダイアログの主要な内容
- title string（オプション） - ダイアログのタイトル
- detail string（オプション） - 追加情報
- buttons strings[]（オプション） - ボタンのテキストの配列
- type string（オプション） - none、 info、 error、question または warning になることができます
返り値 Promise<result: Object>
- resultオブジェクト
  - response Interger - クリックされたボタンのインデックス

let result = await eagle.dialog.showMessageBox({
    title: "Messagebox title",
    message: "Message from the Plugin process",
    detail: "Ultra message here",
    buttons: ["確認", "キャンセル"],
    type: "info"
});

console.log(result);		// {response: 0}

showErrorBox(title, content)

エラーメッセージを表示するダイアログボックス。

title string - エラーボックスに表示されるタイトル
content string - エラーボックスに表示されるテキストコンテンツ
戻り値 Promise<void>

await eagle.dialog.showErrorBox("エラーボックスのタイトル", "プラグインプロセスからのエラーメッセージ");