AR/getElementData

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

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

• addElementDataSubscriber
• clearElementVisibleTo
• cloneElement
• getAllElementData
• getElementSyncer
• getElementZoneName
• hasElementDataSubscriber
• isElementVisibleTo
• removeElementData
• removeElementDataSubscriber
• setElementSyncer
• setElementVisibleTo

Shared

• attachElements
• createElement
• destroyElement
• detachElements
• getAttachedElements
• getElementAlpha
• getElementAttachedOffsets
• getElementAttachedTo
• getElementByIndex
• getElementByID
• getElementChild
• getElementChildren
• getElementChildrenCount
• getElementCollisionsEnabled
• getElementColShape
• getElementData
• getAllElementData
• hasElementData
• getElementDimension
• getElementHealth
• getElementID
• getElementInterior
• getElementMatrix
• getElementModel
• getElementParent
• getElementPosition
• getElementRotation
• getElementsByType
• getElementsWithinColShape
• getElementsWithinRange
• getElementType
• getElementVelocity
• getLowLODElement
• getRootElement
• isElement
• isElementAttached
• isElementCallPropagationEnabled
• isElementDoubleSided
• isElementFrozen
• isElementInWater
• isElementLowLOD
• isElementWithinColShape
• isElementWithinMarker
• setElementAlpha
• setElementAngularVelocity
• getElementAngularVelocity
• setElementAttachedOffsets
• setElementCallPropagationEnabled
• setElementCollisionsEnabled
• setElementData
• setElementDimension
• setElementDoubleSided
• setElementFrozen
• setElementHealth
• setElementID
• setElementInterior
• setElementModel
• setElementParent
• setElementPosition
• setElementRotation
• setElementVelocity
• setLowLODElement
• getPedContactElement
• getResourceDynamicElementRoot
• getResourceRootElement