# Windows GUI 程序指南

## 概述

本示例展示了如何使用 PHPX 编译器创建纯图形界面的 Windows 程序，不显示控制台窗口。

## 关键特性

### 1. 隐藏控制台窗口

通过添加 `--no-console` 编译参数，程序将以 Windows 子系统模式运行，不会显示黑色的控制台终端窗口。

**使用方法：**
```bash
php cli.php build --mode=bin --no-console your-app.php
```

**实现位置：** 
- 选项定义：`src/Php/Constants.php`
- 参数读取：`src/Php/Translator.php`
- 链接配置：`src/Php/CompilerBase.php`

```php
// 对于 bin 模式且指定了 --no-console，使用 Windows 子系统（不显示控制台窗口）
if ($this->buildMode === 'bin' && $this->noConsole) {
    $cmd .= ' /SUBSYSTEM:WINDOWS';
}
```

### 2. 中文支持

#### C++ 层（消息框）

在 C++ 中使用 `MultiByteToWideChar` 将 UTF-8 转换为 UTF-16，然后调用 `MessageBoxW`：

```cpp
// Convert UTF-8 to UTF-16 for Windows API
int wtext_len = MultiByteToWideChar(CP_UTF8, 0, text.data(), -1, NULL, 0);
wchar_t* wtext = new wchar_t[wtext_len];
MultiByteToWideChar(CP_UTF8, 0, text.data(), -1, wtext, wtext_len);

int result = MessageBoxW((HWND)hWnd, wtext, wcaption, (UINT)uType);

delete[] wtext;
delete[] wcaption;
```

#### PHP 层（时区设置）

```php
// Set timezone to China (UTC+8)
date_default_timezone_set('Asia/Shanghai');
```

### 3. 输出方式

由于没有控制台窗口，所有输出必须通过 GUI 元素显示：

- **消息框**：使用 `messagebox()` 或 `MessageBox()` 函数
- **自定义窗口**：需要实现完整的窗口类和消息循环
- **日志文件**：可以写入文件进行调试

## 编译和运行

### 带控制台窗口（默认）

```bash
# 进入示例目录
cd examples/win32-hello

# 编译为带控制台的程序（默认）
php ../../cli.php build --mode=bin hello-win.php

# 运行程序（显示控制台和消息框）
.\hello-win.exe
```

### 不带控制台窗口（GUI 模式）

```bash
# 使用 --no-console 参数编译纯 GUI 程序
php ../../cli.php build --mode=bin --no-console hello-win.php

# 运行程序（只显示消息框，无控制台）
.\hello-win.exe
```

## 注意事项

### ⚠️ 重要限制

1. **没有标准输入输出**
   - `echo`、`print`、`printf` 等控制台输出函数无效
   - `stdin`、`stdout`、`stderr` 不可用
   - 所有输出必须通过 GUI 元素

2. **调试困难**
   - 无法在控制台查看调试信息
   - 建议使用：
     - 消息框显示调试信息
     - 写入日志文件
     - 使用 Visual Studio 调试器附加进程

3. **入口点要求**
   - 使用 `/SUBSYSTEM:WINDOWS` 后，默认入口点是 `WinMain` 而不是 `main`
   - PHPX 编译器会自动处理这个转换

### ✅ 最佳实践

1. **使用消息框进行用户交互**
   ```php
   messagebox(0, "操作成功！", "提示", 0);
   ```

2. **错误处理**
   ```php
   try {
       // 你的代码
   } catch (\Exception $e) {
       messagebox(0, "错误: " . $e->getMessage(), "错误", 16); // MB_ICONERROR
   }
   ```

3. **日志记录**
   ```php
   file_put_contents('app.log', date('Y-m-d H:i:s') . ": 消息\n", FILE_APPEND);
   ```

## 两种模式对比

| 特性 | 控制台模式 (默认) | 窗口模式 (`--no-console`) |
|------|------------------|-------------------------|
| 编译命令 | `php cli.php build app.php` | `php cli.php build --no-console app.php` |
| 链接选项 | `/SUBSYSTEM:CONSOLE` | `/SUBSYSTEM:WINDOWS` |
| 控制台窗口 | ✅ 显示 | ❌ 隐藏 |
| echo/print | ✅ 可用 | ❌ 不可用 |
| stdin/stdout | ✅ 可用 | ❌ 不可用 |
| 消息框 | ✅ 可用 | ✅ 可用 |
| 适用场景 | 命令行工具、调试 | GUI 应用程序 |
| 用户体验 | 黑色终端窗口 | 纯图形界面 |

## 切换模式

### 开发时（带控制台，便于调试）

```bash
# 默认编译，显示控制台
php cli.php build --mode=bin app.php
```

### 发布时（不带控制台，纯 GUI）

```bash
# 使用 --no-console 参数
php cli.php build --mode=bin --no-console app.php
```

### 在 project.yml 中配置

```yaml
build:
  mode: bin
  no_console: true  # 隐藏控制台窗口
```

## 常见问题

### Q: 为什么我的 echo 不显示？

A: 因为使用了 `/SUBSYSTEM:WINDOWS`，控制台被隐藏了。请改用消息框或其他 GUI 元素。

### Q: 如何调试没有控制台的程序？

A: 
1. 使用消息框显示变量值
2. 写入日志文件
3. 使用 Visual Studio 的"附加到进程"功能
4. 临时切换回控制台模式进行调试

### Q: 可以同时显示控制台和窗口吗？

A: 技术上可以，但不推荐。通常的做法是：
- 开发时使用控制台模式便于调试
- 发布时使用窗口模式提供更好的用户体验

### Q: 中文显示乱码怎么办？

A: 确保：
1. C++ 文件使用 UTF-8 编码保存
2. 使用 `MultiByteToWideChar` 转换编码
3. 使用 `MessageBoxW` 而不是 `MessageBoxA`
4. 在 PHP 中设置正确的时区

## 示例代码

### 简单的消息框程序

```php
<?php

function main()
{
    date_default_timezone_set('Asia/Shanghai');
    
    // 欢迎消息
    messagebox(0, 
        "欢迎使用！\n\n" .
        "当前时间: " . date('Y-m-d H:i:s'), 
        "Hello", 
        0);
}
```

### 带错误处理的程序

```php
<?php

function main()
{
    date_default_timezone_set('Asia/Shanghai');
    
    try {
        // 你的业务逻辑
        $result = someOperation();
        
        messagebox(0, "操作成功！结果: " . $result, "成功", 64); // MB_ICONINFORMATION
    } catch (\Exception $e) {
        messagebox(0, "发生错误:\n" . $e->getMessage(), "错误", 16); // MB_ICONERROR
    }
}
```

## 相关资源

- [Windows Subsystem 文档](https://docs.microsoft.com/en-us/cpp/build/reference/subsystem-specify-subsystem)
- [MessageBoxW API](https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-messageboxw)
- [MultiByteToWideChar](https://docs.microsoft.com/en-us/windows/win32/api/stringapiset/nf-stringapiset-multibytetowidechar)