---
title: "TextDrawBackgroundColour | open.mp"
description: "设置文本绘图的背景颜色（轮廓/阴影颜色，非文本框颜色）。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBackgroundColour
language: zh-CN
---

# TextDrawBackgroundColour

注意

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

## 描述

设置文本绘图元素的背景颜色（此颜色影响文本轮廓和阴影，若要设置文本框颜色请使用 [TextDrawBoxColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBoxColour)）。

## 参数

| 参数 | 说明 |
| --- | --- |
| Text:textid | 目标文本绘图的 ID |
| backgroundColour | 要设置的背景颜色值（RGBA） |

## 返回值

此函数不返回特定值。

## 示例

```c
new Text:gMyTextdraw;

public OnGameModeInit()
{
    gMyTextdraw = TextDrawCreate(320.0, 425.0, "示例文本绘图");
    TextDrawUseBox(gMyTextdraw, true);
    TextDrawBackgroundColour(gMyTextdraw, 0xFFFFFFFF); // 设置白色背景
    return 1;
}
```

## 注意事项

备注

当使用 [TextDrawSetOutline](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetOutline) 且轮廓尺寸大于 0 时，轮廓颜色将继承此背景颜色设置。修改此颜色值会影响 [TextDrawColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawColour) 的最终显示效果。

技巧

修改已显示的文本绘图背景颜色时，无需重新创建元素。只需调用 [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): 设置文本字体颜色
-   [TextDrawBoxColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBoxColour): 设置文本框颜色
-   [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): 全局隐藏