MegaManx3: Criou página com 'NOTOC '''ScriptCall''' (str ''classname'', str ''funcname'', ''args'') ==Uso== Executa uma função definida em script. Se o primeiro argumento da função a executar for do tipo {{c|Actor}}, o ativador do script é passado e armazenado nesse argumento. Isso permite que o ativador seja acessado por essa função. ===Parâmetros=== ''classname'': o nome da classe de actor em que a função está definida. ''funcname'': o nome da função a executar. Ap...'

2026-03-06T15:07:09Z

Criou página com '__NOTOC__ '''ScriptCall''' (str ''classname'', str ''funcname'', ''args'') ==Uso== Executa uma função definida em script. Se o primeiro argumento da função a executar for do tipo {{c|Actor}}, o ativador do script é passado e armazenado nesse argumento. Isso permite que o ativador seja acessado por essa função. ===Parâmetros=== *''classname'': o nome da classe de actor em que a função está definida. *''funcname'': o nome da função a executar. Ap...'

Página nova

__NOTOC__
'''ScriptCall''' (str ''classname'', str ''funcname'', ''args'')

==Uso==
Executa uma função [[ZScript|definida em script]]. Se o primeiro argumento da função a executar for do tipo {{c|Actor}}, o ativador do script é passado e armazenado nesse argumento. Isso permite que o ativador seja acessado por essa função.

===Parâmetros===
*''classname'': o nome da classe de actor em que a função está definida.
*''funcname'': o nome da função a executar. Apenas funções '''[[ZScript_functions#Static|static]]''' são executáveis.
*''args'': os argumentos, se houver, a serem passados para a função especificada. Os tipos de argumentos que a função pode ter são ''int'', ''bool'', ''double'', ''string'', ''name'', ''color'' e ''sound''. ''double'' é passado como um valor de ponto fixo, ''color'' como um valor inteiro, e ''name'' e ''sound'' como strings.

===Valor de retorno===
O valor que a função executada retorna. O tipo do valor é o mesmo dos tipos dos argumentos passados, além de ''void''.

==Exemplos==
Este script dá ao jogador um [[TID]] único. Isso é obtido executando {{c|[[FindUniqueTid]]}}, que é definido em {{c|{{Class|Actor}}}}.
script "SetPlayerTID" {{SType|Enter}}
{
// Apenas se o jogador ainda não tiver um TID.
if([[ActivatorTID]]() == 0)
{
int ptid = [[ScriptCall]]("Actor", "FindUniqueTid", 0, 0);
[[Thing_ChangeTID]](0, ptid);
[[Log]](s:"TID alterado para ", d:ptid); // Mostra uma mensagem.
}
}

Note que o ACS já tem [[UniqueTID|uma função que pode obter um TID único]]. O exemplo acima é para fins educacionais.

Se executada, esta função {{c|GivePresent}} dá ao ativador do script um item e registra uma mensagem. O item é especificado pelo argumento ''present''.
// Em [[ZScript]]:
class ExampleClass
{
static void GivePresent (Actor activator, string present)
{
// Apenas jogadores recebem o item.
if(activator && activator.player)
{
activator.[[A_GiveInventory]](present);
activator.[[A_Log]]("You received a wonderful present!", true);
}
}
}

// Em [[ACS]]:
script "GetGift" (void)
{
[[ScriptCall]]("ExampleClass", "GivePresent", "{{Class|Soulsphere}}");
}

[[Category:ACS]]

ScriptCall - Histórico de revisão