# window（ウィンドウ）
以下は `window` の一般的な機能の例です：
```javascript
await eagle.window.show(); // プラグインウィンドウを表示する
await eagle.window.hide(); // プラグインウィンドウを隠す
await eagle.window.minimize(); // ウィンドウを最小化する
await eagle.window.restore(); // 最小化を元に戻す
await eagle.window.maximize(); // ウィンドウを最大化する
await eagle.window.unmaximize(); // 最大化を元に戻す
await eagle.window.setFullScreen(true); // フルスクリーンに設定する
await eagle.window.setFullScreen(false); // フルスクリーンを終了する
```
***
#### メソッド
## show()
ウィンドウを表示し、フォーカスします。
* 戻り値 `Promise<>`
```javascript
await eagle.window.show();
```
***
## showInactive()
ウィンドウを表示しますが、フォーカスしません。
* 戻り値 `Promise<>`
```javascript
await eagle.window.showInactive();
```
***
## hide()
プラグインウィンドウを非表示にします。
* 戻り値 `Promise<>`
```javascript
await eagle.window.hide();
```
***
## focus()
プラグインウィンドウにフォーカスします。
* 戻り値 `Promise<>`
```javascript
await eagle.window.focus();
```
***
## minimize()
プラグインウィンドウを最小化します。
* 戻り値 `Promise<>`
```javascript
await eagle.window.minimize();
```
***
## isMinimized()
ウィンドウが最小化されているかどうかを判断します。
* 戻り値 `Promise`
* `minimized` boolean - ウィンドウが最小化されているかどうか
```javascript
let isMinimized = await eagle.window.isMinimized();
```
***
## restore()
プラグインウィンドウを最小化状態から元の状態に戻します。
* 戻り値 `Promise<>`
```javascript
await eagle.window.restore();
```
***
## maximize()
プラグインウィンドウを最大化します。ウィンドウがまだ表示されていない場合、このメソッドはそれを表示します（ただし、フォーカスはしません）。
* 戻り値 `Promise<>`
```javascript
await eagle.window.maximize();
```
***
## unmaximize()
プラグインウィンドウの最大化を解除します
* 戻り値 `Promise<>`
```javascript
await eagle.window.unmaximize();
```
***
## isMaximized()
ウィンドウが最大化されているかどうかを判断します
* 戻り値 `Promise`
* `maximized` boolean - ウィンドウが最大化されているかどうか
```javascript
let isMaximized = await eagle.window.isMaximized();
```
***
## setFullScreen(flag)
ウィンドウが全画面モードにするかどうかを設定します。
* `flag` boolean - 全画面にするかどうか
* 返り値 `Promise<>`
```javascript
await eagle.window.setFullScreen(true); // 全画面に入る
await eagle.window.setFullScreen(false); // 全画面から退出
```
***
## isFullScreen()
ウィンドウが全画面かどうかを判断します。
* 返り値 `Promise`
* `fullscreen` boolean - ウィンドウが全画面かどうか
```javascript
let isMaximized = await eagle.window.isMaximized();
```
***
## setAspectRatio(aspectRatio)
ウィンドウのアスペクト比を保持します。
* `aspectRatio` Float - 保持するアスペクト比（幅 / 高さ）
* 返り値 `Promise<>`
```javascript
await eagle.window.setAspectRatio(16/9); // ウィンドウのアスペクト比を 16:9 に制限
```
***
## setBackgroundColor(backgroundColor)
ウィンドウの背景色を設定します。
* `backgroundColor` String - このパラメーターは、希望する背景色のHEXコードを表します。 Promise<>を返します。
* 返り値 `Promise<>`
```javascript
await eagle.window.setBackgroundColor("#FFFFFF");
```
{% hint style="info" %}
注1：この属性は、manifest.json で直接設定できます。
注2：この設定は主に、HTML / CSS のコンテンツがまだ読み込まれていない状態で、ウィンドウのデフォルトの背景色を設定するために使用されます。適切な設定で、ウィンドウ表示がフラッシュする状況を防ぐことができます。
{% endhint %}
***
## setSize(width, height)
ウィンドウのサイズを設定します。
* `width` Integer - ウィンドウの幅
* `height` - Integer - ウィンドウの高さ
* 返り値 `Promise<>`
```javascript
await eagle.window.setSize(720, 480);
```
{% hint style="info" %}
注：この属性は、manifest.json で直接設定できます。
{% endhint %}
## getSize()
ウィンドウのサイズを取得します。
* 返り値 `Promise`
```javascript
await eagle.window.getSize();
```
## setBounds(**bounds**)
ウィンドウのサイズを調整し、指定された境界に移動します。提供されていない属性は、現在の値がデフォルトとなります。
```javascript
await eagle.window.setBounds({ x: 440, y: 225, width: 800, height: 600 })
```
## getBounds()
ウィンドウの境界を取得します。
* 返り値 `Promise` - ウィンドウ境界のオブジェクト
```javascript
await eagle.window.getBounds()
```
## setResizable(resizable)
ウィンドウのサイズを調整できるかどうかを設定します。
* `resizable` boolean - サイズを調整できるかどうか
* 返り値 `Promise<>`
```javascript
await eagle.window.setResizable(true);
await eagle.window.setResizable(false);
```
{% hint style="info" %}
注：この属性は、manifest.json で直接設定できます。
{% endhint %}
***
## isResizable()
ウィンドウのサイズを調整できるかどうかを判断します。
* 返り値 `Promise`
* `resizable` boolean
```javascript
let isResizable = await eagle.window.isResizable();
```
***
## setAlwaysOnTop(flag)
ウィンドウが常に他のウィンドウの前に表示されるかどうかを設定します。
* `flag` boolean
* 返り値 `Promise<>`
```javascript
await eagle.window.setAlwaysOnTop(true);
await eagle.window.setAlwaysOnTop(false);
```
***
## isAlwaysOnTop()
ウィンドウが常に他のウィンドウの前に表示されるかどうかを判断します。
* 返り値 `Promise`
* `alwaysOnTop` boolean
```javascript
let isAlwaysOnTop = await eagle.window.isAlwaysOnTop();
```
***
## setPosition(x, y)
ウィンドウを x と y に移動します。
* `x` Integer
* `y` Integer
* 返り値 `Promise<>`
```javascript
await eagle.window.setPosition(100, 200);
```
***
## getPosition()
プラグインウィンドウの座標 x と y を取得します。
* 返り値 `Promise`
* `position` Integer\[]
* x - position\[0]
* y - position\[1]
```javascript
let position = await eagle.window.getPosition(); // [100, 200]
```
***
## setOpacity(opacity)
ウィンドウの不透明度を設定します。範囲外の値は、\[0, 1]の範囲に制限されます。
* `opacity` number - 0.0（完全に透明）と1.0（完全に不透明）の間
* 返り値 `Promise<>`
```javascript
await eagle.window.setOpacity(0.5);
```
***
## getOpacity()
ウィンドウの透明度を取得します。0.0（完全に透明）から1.0（完全に不透明）の間。
* 返り値 `Promise`
* `opacity` number
```javascript
let opacity = await eagle.window.getOpacity();
```
***
## flashFrame(flag)
ウィンドウのフレームの点滅を開始または停止して、ユーザーの注意を引きます。
* `flag` boolean - 点滅するかどうか
* 返り値 `Promise<>`
```javascript
await eagle.window.flashFrame(true);
await eagle.window.flashFrame(false);
```
***
## setIgnoreMouseEvents(ignore)
ウィンドウ内のすべてのマウスイベントを無視します。このウィンドウで発生するすべてのマウスイベントは、このウィンドウの下のウィンドウに渡されますが、このウィンドウがフォーカスを持っている場合、キーボードイベントは引き続き受け取ります。
* `ignore` boolean - マウスイベントを無視するかどうか
* 返り値 `Promise<>`
```javascript
await eagle.window.setIgnoreMouseEvents(true);
await eagle.window.setIgnoreMouseEvents(false);
```
{% hint style="info" %}
setAlwaysOnTop() 機能と組み合わせると、画面の最前面に表示され、マウスクリックが透過する特別なウィンドウを作成できます。
{% endhint %}
## capturePage(rect)
指定された `rect` エリア内のページのスナップショットをキャプチャします。`rect` を省略すると、表示されているページ全体をキャプチャします。
* `rect` オブジェクト - 任意、スクリーンショット範囲
* `x` 数値
* `y` 数値
* `width` 数値
* `height` 数値
* 返り値 `Promise<[NativeImage](https://www.electronjs.org/docs/latest/api/native-image)>`
```javascript
const image = await eagle.window.capturePage();
const base64 = image.toDataURL("image/jpeg");
const image2 = await eagle.window.capturePage({ x: 0, y: 0, width: 100, height: 50 });
const buffer = image2.toPNG();
```
## setReferer(url)
関数は現在のリファラーURLを設定するために使用されます。リファラーが設定されると、その後のリクエストはこのリファラーを使用します。
* `url` string - リファラーのURL
* 返り値 `void`
```javascript
eagle.window.setReferer("https://jp.eagle.cool");
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developer.eagle.cool/plugin-api/ja-jp/api/window.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.