---
title: "TextDrawAlignment | open.mp"
description: "设置文本绘图中文字的对齐方式。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawAlignment
language: zh-CN
---

# TextDrawAlignment

## 描述

设置文本绘图中文字内容的对齐方式。

| 参数名称 | 说明 |
| --- | --- |
| Text:textid | 需要设置对齐方式的文本绘图 ID |
| TEXT\_DRAW\_ALIGN:alignment | 对齐模式：`TEXT_DRAW_ALIGN_LEFT`（左对齐）/ `TEXT_DRAW_ALIGN_CENTER`（居中）/ `TEXT_DRAW_ALIGN_RIGHT`（右对齐） |

## 返回值

此函数不返回特定值。

## 示例代码

```c
/*
    TEXT_DRAW_ALIGN_LEFT
    TEXT_DRAW_ALIGN_CENTER
    TEXT_DRAW_ALIGN_RIGHT
*/

new Text:gMyTextdraw;

public OnGameModeInit()
{
    gMyTextdraw = TextDrawCreate(320.0, 425.0, "这是一个示例文本绘图");
    TextDrawAlignment(gMyTextdraw, TEXT_DRAW_ALIGN_CENTER); // 设置文本内容居中对齐
    return 1;
}
```

## 注意事项

备注

-   使用`TEXT_DRAW_ALIGN_CENTER`居中对齐时：
    -   必须交换[TextDrawTextSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawTextSize)参数的 x/y 坐标值
    -   文本绘图的坐标定位点将变为中心点而非左上角
-   若文本绘图已处于显示状态，修改对齐方式后需重新调用显示函数([TextDrawShowForAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForAll)/[TextDrawShowForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForPlayer))才能生效

## 相关函数

-   [TextDrawCreate](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawCreate): 创建文本绘图
-   [TextDrawDestroy](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawDestroy): 销毁文本绘图
-   [TextDrawGetAlignment](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetAlignment): 获取当前对齐方式
-   [TextDrawColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawColor): 设置文本颜色
-   [TextDrawBoxColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBoxColor): 设置边框颜色
-   [TextDrawBackgroundColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBackgroundColor): 设置背景色
-   [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): 全局隐藏