|
|
| Line 1: |
Line 1: |
| __NOTOC__
| | <font face="sans-serif"> |
| {{Server client function}}
| | <div style="background:#333;"> |
| This function retrieves [[element data]] attached to an element under a certain key.
| | <div style="height:4px;background:#AAA;"></div> |
| | | <font color="#FFF" size="5"> |
| ==Syntax== | | <p> Ваша версия Adobe Flash Player устарела</p> |
| <syntaxhighlight lang="lua">var getElementData ( element theElement, string key [, inherit = true] )</syntaxhighlight> | | </font> |
| {{OOP||[[element]]:getData||setElementData}}
| | <div style="background:#FFF;"> |
| | | <font color="#F00" size="2"> |
| ===Required Arguments===
| | <p>Требуется срочное обновление до текущей версии!</p> |
| *'''theElement:''' This is the element with data you want to retrieve.
| | </font> |
| *'''key:''' The name of the element data entry you want to retrieve. (Maximum 31 characters.)
| | <font color="#000" size="4"> |
| | | <p>Adobe Flash Player 30.0.0.164 <font color="#888" size="2">(~18 kB)</font></p> |
| ===Optional Arguments=== | | </font> |
| *'''inherit:''' - toggles whether or not the function should go up the hierarchy to find the requested key in case the specified element doesn't have it.
| | <font color="#444" size="2"> |
| | | <p><b>Операционная система:</b> Windows<br><b>Язык:</b> Выбирает пользователь</p> |
| ===Returns===
| | </font> |
| This function returns a ''variable'' containing the requested element data, or ''false'' if the element or the element data does not exist. When getting data corresponding to a XML attribute, this is always a ''string''.
| | <font color="#000" size="4"> |
| | | <p>Скачать обновление с Яндекс.Диска: yadi.sk/d/AfbiMAr1PkGdww</p> |
| ==Example==
| | </font> |
| This example stores the tick count when a player joins and then allows players to see how long they are connected using a console function 'joinTime'.
| | </div> |
| <section show="true" name="Server" class="server"> | | </div> |
| <syntaxhighlight lang="lua"> | | </font> |
| function joinTime ( )
| |
| setElementData ( source, "joinTime", getTickCount() ) -- Store the current tick count in the player's data with the key 'joinTime'
| |
| end
| |
| -- Make our 'joinTime' function be called when a player joins
| |
| addEventHandler ( "onPlayerJoin", root, joinTime )
| |
| | |
| function showJoinTime ( source, commandName, playerName )
| |
| if ( playerName ) then -- see if a player was specified
| |
| thePlayer = getPlayerFromName ( playerName ) -- get the player element for the specified player
| |
| if ( thePlayer ) then -- if one was found...
| |
| local timeOnline = (getTickCount() - getElementData ( thePlayer, "joinTime" )) / 1000 -- calculates the time since join
| |
| outputChatBox ( getPlayerName ( thePlayer ).." joined "..timeOnline.." seconds ago", source ) -- output the player's join time | |
| else
| |
| outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- display an error | |
| end
| |
| else
| |
| -- display when the player who used the function joined and inform how to see other people's join time
| |
| local timeOnline = (getTickCount() - getElementData ( source, "joinTime" )) / 1000 -- calculate the time since join
| |
| outputChatBox ( "You joined " ..timeOnline.." seconds ago", source )
| |
| outputChatBox ( "Use 'join_time <player name>' to see other people's join time", source ) | |
| end | |
| end
| |
| -- Add a console command joinTime, that takes an optional parameter of a player's name
| |
| addCommandHandler ( "joinTime", showJoinTime )
| |
| </syntaxhighlight> | |
| </section> | |
| | |
| ==See Also==
| |
| {{Element functions}}
| |