---
title: "maximize"
description: "最大化当前 Windows 窗口。"
---


> 最大化当前 Windows 窗口。

## 签名

```ts
KSM.window.maximize(): Promise<{ updated: boolean }>
```

## 平台与权限

| Windows | Android |权限 |
| --- | --- | --- |
|支持 |不支持 | `window.control` |

## 参数

无。

## 返回值

|字段 |类型 |说明 |
| --- | --- | --- |
| `updated` | `boolean` |窗口服务是否接受最大化操作 |

## 行为

- Windows 调用 `ShowWindow(window, SW_MAXIMIZE)`。
- Android 返回 `NOT_SUPPORTED`，能力列表不包含该命令。
- 不提供还原窗口或设置最大尺寸的方法。

## 示例

```ts
const { commands } = await KSM.capabilities();

if (commands.includes('window.maximize')) {
  await KSM.window.maximize();
}
```

## 错误

|错误 |场景 |
| --- | --- |
| `PERMISSION_DENIED` | `window.control` 不可用 |
| `NOT_SUPPORTED` | Android 或宿主没有配置窗口服务 |
| `TIMEOUT` |宿主未在默认时间内响应 |

## 相关

- [minimize](/docs/kasumi/api/window/minimize)
- [window 模块](/docs/kasumi/api/window)