
# デスクトップのウィンドウ

macOS、Windows、Linux では、ネイティブのウィンドウが、最初のフレームが表示される前にプロパティから設定されます。タイトル、タイトルバーのスタイル、そして初期、最小、最大のサイズです。二つのウィジェットが、独自のタイトルバーを描くアプリを助けます。スマートフォンと Web はこれらのキーを無視します。

## 使う理由

デスクトップアプリでは通常、ウィンドウのサイズを決めたりタイトルバーを隠したりするのに、各ランナーのネイティブのコード (Swift、C++、C) や `window_manager` のようなプラグインが必要です。ここではそれは設定で、必要ならプラットフォームごとに変えられ (`application-macos.yml`)、ウィンドウは最初から設定どおりに表示されます。ランナーのサイズから指定したサイズへのちらつきはありません。

## 例

```yaml
# lib/resources/application-desktop.yml: macOS、Windows、Linux
spring:
  flutter:
    desktop:
      window:
        title: NEON Books              # タイトルバー、Dock、タスクバー
        title-bar: transparent         # default | transparent | hidden
        initial-size: 1280x800         # 論理ピクセル、中央に配置
        min-size: 800x600              # ユーザーはこれより小さくできない
        max-size: 1920x1080            # ... これより大きくもできない
```

## プロパティ

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.desktop.window.title` | テキスト | ランナーのもの (通常はアプリの名前) | ウィンドウのタイトル。タイトルバーが見えるときに OS がそこに表示するもの (`transparent` や `hidden` では表示されない)、および Dock、タスクバー、ウィンドウスイッチャーでのもの。前後の空白は取り除かれ、空の値はないのと同じ |
| `spring.flutter.desktop.window.title-bar` | `default`、`transparent`、`hidden` | `default` | `default`: OS のタイトルバーをそのまま。`transparent`: コンテンツは透明なタイトルバーの下に描かれ、ウィンドウのボタンはその上に残る。`hidden`: タイトルバーもウィンドウのボタンもなく、アプリが独自のものを描く |
| `spring.flutter.desktop.window.initial-size` | `<width>x<height>`、論理ピクセル | ランナーのサイズ | ウィンドウが開くときのコンテンツ領域のサイズ。画面の中央に配置される (コンポジターがウィンドウを配置する Wayland を除く) |
| `spring.flutter.desktop.window.min-size` | `<width>x<height>` | なし | ユーザーがウィンドウをドラッグして縮められる最小のコンテンツのサイズ |
| `spring.flutter.desktop.window.max-size` | `<width>x<height>` | なし | ユーザーがウィンドウをドラッグして広げられる最大のコンテンツのサイズ |

不正な形式のサイズ (`1280x`、負やゼロの数値) や、互いに矛盾するサイズ (最小 ≤ 初期 ≤ 最大でなければなりません) は、値を示して起動を止めます。スマートフォンや Web では、不正な形式の値であってもキーは読まれません。

## プラットフォームごとのタイトルバー

| スタイル | macOS | Windows | Linux |
|---|---|---|---|
| `transparent` | 透明なタイトルバー、非表示のタイトル、フルサイズのコンテンツビュー。信号機ボタンはコンテンツの上 | フレームをクライアント領域に拡張。システムのキャプションボタンはコンテンツの上 | GTK はヘッダーバーの下にコンテンツを描かないため、ウィンドウのボタンを持つタイトルなしの独自の平坦なヘッダーバーになる |
| `hidden` | タイトルバーなし、ボタンなし | キャプションなし | 装飾なし |

`max-size` を持つウィンドウの最大化: macOS のズームはそこで止まり、Windows は許される最大のサイズに最大化し、Linux のウィンドウマネージャーはそれを超える最大化を拒否することがあります。

## 独自のタイトルバーを描く

```dart
Widget build(BuildContext context) {
  // 信号機ボタン (macOS、左側) やキャプションボタン (Windows、右側) の
  // ための余白。デフォルトのタイトルバーではゼロ。
  final insets = DesktopWindow.insetsOf(context);
  return WindowDragArea(
    child: Padding(
      padding: EdgeInsets.only(left: insets.left, right: insets.right),
      child: const SizedBox(height: 48, child: Text('NEON Books')),
    ),
  );
}
```

- `WindowDragArea` は、主ボタンを押したままポインターが動くと OS のウィンドウのドラッグを始め (そのため、その中のクリックやボタンはドラッグになりません)、ダブルクリックで OS と同じくウィンドウを最大化または元に戻します (`doubleClickMaximizes: false` で何もしません)。
- `DesktopWindow.insetsOf(context)` はウィンドウのボタンが占める余白を返します。`DesktopWindow.of(context)` は適用されたタイトルバーのスタイルも伝えます。

## ちらつきなし

ランナーは最初のフレームとともにウィンドウを表示するため、スターターはネイティブ側がウィンドウを設定するまで (最大 5 秒) 最初のフレームを保留します。ウィンドウは設定どおりに表示されます。これらのプロパティを持たないアプリは、環境を待つそのフレーム以外に何も負担しません。

プラットフォームのコードはこのパッケージ独自のもの (Flutter のプラグインで、`window_manager` なし) です。macOS では Swift、Windows では C++、Linux では C です。まだできていないもの: ウィンドウの位置、ユーザーが残したサイズと位置の復元。

## 関連項目

- [Flutter アプリでの設定](configuration.md)
- [SpringApplicationWidget](application-widget.md)
- [すべてのプロパティ](properties.md)
