Instance

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

O tipo de dado Instance armazena construtores para Instance objetos.

Resumo

Construtores

Construtores

new

Cria um novo Instance de tipo className. As classes e serviços abstratos não podem ser criados com este construtor.

Observe que quando o Parent de um objeto é configurar, o Luau ouve uma variedade de diferentes alterações de propriedade para replicação, renderização e física.Por razões de desempenho, é recomendado definir a propriedade última da instância quando criar novos objetos, em vez de especificar o segundo argumento ( último) deste construtor.


local Workspace = game:GetService("Workspace")
-- Defina o pai da nova instância último (recomendado)
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Parent = Workspace
-- Definir o pai da nova instância no construtor (desencorajado)
local part = Instance.new("Part", Workspace)
part.Position = Vector3.new(0, 10, 0)

Parâmetros

className: string

Nome da classe da nova instância a Criar.

parent: Instance

Objeto opcional para parente da nova instância. Não recomendado por motivos de desempenho (veja a descrição acima).

fromExisting

Cria um novo objeto com os mesmos tipos e valores de propriedade de um Objetoexistente.Na maioria dos casos, usar Instance:Clone() é mais apropriado, mas este construtor é útil ao implementar bibliotecas ou sistemas de baixo nível.

Existem duas diferenças de comportamento entre este construtor e o método Instance:Clone():

  • Este construtor não copiará nenhum dos descendentes Instances parente para o Objetoexistente.

  • Este construtor retornará um novo objeto mesmo que o objeto existente tivesse Instance.Archivable definido para false.

Parâmetros

existingInstance: Instance

O existente Instance para copiar os valores das propriedades.