Vampire: Translation of the page 'getElementData' to Portuguese BR

2022-01-31T18:31:32Z

Translation of the page 'getElementData' to Portuguese BR

New page

__NOTOC__
{{BR/Funcao compartilhada}}
Esta função recupera dados de elemento anexados a um elemento em uma determinada chave.

==Sintaxe==
<syntaxhighlight lang="lua">var getElementData ( element theElement, string key [, bool inherit = true] )</syntaxhighlight>
{{PT-BR/POO||[[element]]:getData||setElementData}}

===Argumentos Obrigatórios===
*'''theElement:''' Este é o elemento com dados que você deseja recuperar.
*'''key:''' O nome da entrada de dados do elemento que você deseja recuperar. (Máximo de 31 caracteres.)

===Argumentos Opcionai===
*'''inherit:''' - alterna se a função deve ou não subir na hierarquia para encontrar a chave solicitada caso o elemento especificado não a tenha.

===Retorna===
Esta função retorna uma ''variável'' contendo os dados do elemento solicitado, ou ''false'' se o elemento ou os dados do elemento não existirem. Ao obter dados correspondentes a um atributo XML, isso é sempre uma ''string''.

==Exemplo==
Este exemplo armazena a contagem de ticks quando um jogador entra e permite que os jogadores vejam quanto tempo eles estão conectados usando uma função 'joinTime' do console.
<section show="true" name="Server" class="server">
<syntaxhighlight lang="lua">
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}}

[[en:getElementData]]

PT-BR/getElementData - Revision history

Vampire: Translation of the page 'getElementData' to Portuguese BR