---
title: "TogglePlayerWidescreen | open.mp"
description: "切换玩家的宽屏显示模式"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TogglePlayerWidescreen
language: zh-CN
---

# TogglePlayerWidescreen

注意

这个函数是在omp v1.1.0.2612中添加的，在以前的版本中不起作用！

## 描述

动态切换玩家的宽屏显示状态，控制游戏画面比例。

| 参数 | 说明 |
| --- | --- |
| playerid | 需操作的玩家 ID |
| bool:wide | 设为**true**启用宽屏模式，**false**恢复默认比例 |

## 返回值

**true** - 函数执行成功

**false** - 函数执行失败（通常表示指定玩家不存在）

## 示例代码

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/widescreen", true))
    {
        TogglePlayerWidescreen(playerid, true);
        SendClientMessage(playerid, -1, "服务器：你已启用宽屏显示！");
        return 1;
    }
    return 0;
}
```

* * *

**宽屏启用效果：**

**宽屏禁用效果：**

## 相关函数

-   [IsPlayerWidescreenToggled](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsPlayerWidescreenToggled): 检测玩家当前宽屏状态