SendClientMessagef
This function was added in open.mp beta build 6 and will not work in earlier versions!
این تابع منسوخ شده.
تابع SendClientMessage الان بصورت built-in فرمت رو ساپورت میکنه!
توضیحات
این تابع یه پیام فرمت شده با رنگ انتخابی به بازیکن خاص در چت ارسال میکنه. کل خط در chatbox به رنگ تنظیم شده خواهد بود، مگر اینکه از color embedding استفاده بشه.
نام | توضیحات |
---|---|
playerid | ID بازیکن که پیام براش نمایش داده بشه. |
color | رنگ پیام (فرمت 0xRRGGBBAA Hex). |
const message[] | متنی که نمایش داده میشه (حداکثر 144 کاراکتر). |
{Float, _}:... | تعداد نامحدودی آرگومان از هر نوع |
مقدار برگشتی
1: تابع با موفقیت اجرا شد. موفقیت وقتی گزارش میشه که string بیشتر از 144 کاراکتر باشه، ولی پیام ارسال نمیشه.
0: تابع اجرا نشد. بازیکن متصل نیست.
مشخصههای فرمت
مشخصه | معنی |
---|---|
%i | Unsigned Integer |
%d | Signed Integer |
%s | String |
%f | عدد اعشاری |
%c | کاراکتر ASCII |
%x | عدد هگزادسیمال |
%b | عدد باینری |
%% | علامت '%' به صورت literal |
%q | Escape کردن متن برای SQLite. (اضافه شده در 0.3.7 R2) |
مثالها
#define COLOR_RED 0xFF0000FF
public OnPlayerConnect(playerid)
{
new number = 5;
SendClientMessagef(playerid, -1, "The variable above is %i", number);
return 1;
}
نکات
میتونی از color embedding برای چندین رنگ در پیام استفاده کنی. استفاده از '-1' به عنوان رنگ، متن رو سفید میکنه (به دلیل ساده که -1 وقتی در نمایش هگزادسیمال نمایش داده بشه، 0xFFFFFFFF هست).
اگر پیام بیشتر از 144 کاراکتر باشه، ارسال نمیشه. میتونی از truncation برای جلوگیری ازش استفاده کنی. نمایش پیام در چندین خط هم این مشکل رو حل میکنه.