پرش به مطلب اصلی

SendClientMessagef

هشدار

This function was added in open.mp beta build 6 and will not work in earlier versions!

هشدار

این تابع منسوخ شده.

تابع SendClientMessage الان بصورت built-in فرمت رو ساپورت می‌کنه!

توضیحات

این تابع یه پیام فرمت شده با رنگ انتخابی به بازیکن خاص در چت ارسال می‌کنه. کل خط در chatbox به رنگ تنظیم شده خواهد بود، مگر اینکه از color embedding استفاده بشه.

نامتوضیحات
playeridID بازیکن که پیام براش نمایش داده بشه.
colorرنگ پیام (فرمت 0xRRGGBBAA Hex).
const message[]متنی که نمایش داده می‌شه (حداکثر 144 کاراکتر).
{Float, _}:...تعداد نامحدودی آرگومان از هر نوع

مقدار برگشتی

1: تابع با موفقیت اجرا شد. موفقیت وقتی گزارش می‌شه که string بیشتر از 144 کاراکتر باشه، ولی پیام ارسال نمی‌شه.

0: تابع اجرا نشد. بازیکن متصل نیست.

مشخصه‌های فرمت

مشخصهمعنی
%iUnsigned Integer
%dSigned Integer
%sString
%fعدد اعشاری
%cکاراکتر ASCII
%xعدد هگزادسیمال
%bعدد باینری
%%علامت '%' به صورت literal
%qEscape کردن متن برای 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 برای جلوگیری ازش استفاده کنی. نمایش پیام در چندین خط هم این مشکل رو حل می‌کنه.