AR/getElementData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Server client function}} هذه الوظيقة تقوم بجلب بيانات الالمنت الموجودة على مفتاح معين. ==Syntax== <syntaxhighlight lang="lua">[lua,n...")
 
Line 19: Line 19:


==مثال==
==مثال==
هذا المثال يخزن وقت دخول اللاعب بالميلي ثانية ليسمح لهم بمعرفة كم مدة اتصالهم بأستخدام وظيفة 'joinTime'.
هذا المثال يخزن وقت دخول اللاعب بالميلي ثانية ليسمح لهم بمعرفة كم مدة اتصالهم بوظيفة 'joinTime'.
<section show="true" name="سيرفر" class="server">
<section show="true" name="سيرفر" class="server">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">

Revision as of 00:50, 12 August 2016

هذه الوظيقة تقوم بجلب بيانات الالمنت الموجودة على مفتاح معين.

Syntax

var getElementData ( element theElement, string key [, inherit = true] )

OOP Syntax Help! I don't understand this!

Method: element:getData(...)
Counterpart: setElementData


العناصر المطلوبة

  • theElement: العنصر الذي تود جلب بياناته .
  • key: اسم مفتاح بيانات العنصر الذي تود جلبها . x ( 31 حرف كحد أقصى للمفتاح )

العناصر الاختارية

  • inherit: - تفعيل الوظيفة أم لا التي يجب ان تذهب أعلى التسلسل الهرمي للعثور على المفتاح المطلوب في حالة ان العنصر المحدد لا يملكها.

النواتج

هذه الدالة تقوم بإرجاع متغير يحتوي على بيانات العنصر المطلوب، أو خطأ إذا كان العنصر أو بيانات العنصر غير موجودة .

مثال

هذا المثال يخزن وقت دخول اللاعب بالميلي ثانية ليسمح لهم بمعرفة كم مدة اتصالهم بوظيفة 'joinTime'.

Click to collapse [-]
سيرفر
function joinTime ( )
    setElementData ( source, "joinTime", getTickCount() ) -- تخزين الوقت الصحيح بالميلي ثانية لدى اللاعب مع المفتاح 'joinTime'
end
-- صنع وظيفتنا لوقت الدخول لتقوم بعملها عندما يدخل لاعب
addEventHandler ( "onPlayerJoin", root, joinTime )

function showJoinTime ( source, commandName, playerName )
	if ( playerName ) then -- تحقق من اسم اللاعب المحدد
		thePlayer = getPlayerFromName ( playerName ) -- جلب عنصر اللاعب للاعب المحدد
		if ( thePlayer ) then -- اذا كان موجوداً ...
			local timeOnline = (getTickCount() - getElementData ( thePlayer, "joinTime" )) / 1000 -- جلب بيانات اللاعب منذ الدخول وحسابها
			outputChatBox ( getPlayerName ( thePlayer ).." joined "..timeOnline.." seconds ago", source ) -- اخراج وقت دخول اللاعب في الشات
		else
			outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- عرض خطأ اذا كان اللاعب غير موجود
		end
	else
		-- عرض للاعب الذي قام بكتابة الامر طريقة استخدام الوظيفة ليرى وقت دخول الاشخاص الاخرين
		local timeOnline = (getTickCount() - getElementData ( source, "joinTime" )) / 1000 -- حساب وقت دخول اللاعب
		outputChatBox ( "You joined " ..timeOnline.." seconds ago", source )
		outputChatBox ( "Use 'join_time <player name>' to see other people's join time", source )
	end
end
-- اضافة امر وقت الدخول , مع عنصر اضافي وهو اسم اللاعب
addCommandHandler ( "joinTime", showJoinTime )

See Also

Shared