---
title: "TextDrawBoxColour | open.mp"
description: "调整文本绘图的方框颜色（仅在 TextDrawUseBox 的 'enableBox' 参数为 'true' 时生效）。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBoxColour
language: zh-CN
---

# TextDrawBoxColour

注意

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

## 描述

调整文本绘图的方框颜色（仅在 TextDrawUseBox 的 'enableBox' 参数设置为 'true' 时生效）。

| 参数 | 说明 |
| --- | --- |
| Text:textid | 需要修改的文本绘图 |
| boxColour | 方框颜色。透明度由颜色的 alpha 通道决定（例如 0x000000FF 表示完全不透明的黑色方框，0x000000AA 表示半透明的黑色方框）。 |

## 返回值

此函数不返回特定值。

## 示例

```c
new Text:gMyTextdraw;

public OnGameModeInit()
{
    gMyTextdraw = TextDrawCreate(123.0, 123.0, "Example");
    TextDrawUseBox(gMyTextdraw, true);
    TextDrawBoxColour(gMyTextdraw, 0xFFFFFFFF);
    return 1;
}
```

## 注意事项

技巧

若要修改已显示的文本绘图的方框颜色，无需重新创建。只需在修改后使用[TextDrawShowForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForPlayer)/[TextDrawShowForAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForAll)即可立即生效。

## 相关函数

-   [TextDrawCreate](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawCreate): 新建一个文本绘图
-   [TextDrawDestroy](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawDestroy): 删除指定文本绘图
-   [TextDrawColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawColour): 调整文本绘图的文字颜色
-   [TextDrawBackgroundColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBackgroundColour): 修改文本绘图的背景颜色
-   [TextDrawAlignment](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawAlignment): 调整文本绘图的文字对齐方式
-   [TextDrawFont](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawFont): 更改文本绘图的字体样式
-   [TextDrawLetterSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawLetterSize): 调节文本绘图的字符大小
-   [TextDrawTextSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawTextSize): 定义文本绘图方框的尺寸
-   [TextDrawSetOutline](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetOutline): 控制文本轮廓的显示状态
-   [TextDrawSetShadow](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetShadow): 切换文本阴影的启用状态
-   [TextDrawSetProportional](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetProportional): 启用文本字符的比例间距
-   [TextDrawUseBox](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawUseBox): 控制文本绘图方框的显示开关
-   [TextDrawSetString](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetString): 修改现有文本绘图的文字内容
-   [TextDrawShowForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForPlayer): 向指定玩家显示文本绘图
-   [TextDrawHideForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawHideForPlayer): 对指定玩家隐藏文本绘图
-   [TextDrawShowForAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForAll): 向所有在线玩家显示文本绘图
-   [TextDrawHideForAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawHideForAll): 全局隐藏指定文本绘图