Tween
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
O objeto Tween controla a reprodução de uma interpolação.Criar e configurar um Tween é feito com a função TweenService:Create() ; Instance.new() não pode ser usada para esse Objetoespecífico.
Observe que, enquanto a configuração de um tween pode ser acessada após a criação de um tween, não pode ser modificada.Se novos objetivos forem necessários para uma interpolação, um novo Tween deve ser criado.
Observe também que vários adolescentes podem ser jogados no mesmo objeto ao mesmo tempo, mas eles não devem estar interpolando a mesma propriedade.Se dois adolescentes tentarem modificar a mesma propriedade, o tween inicial será cancelado e substituído pelo interseçãomais recente.
Amostras de código
In this example a Tween is created to animate the position and color of a Part. Because the position and color are part of the same tween, they will change at the exact same rate and will reach their goal at the same time.
local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Color = Color3.new(1, 0, 0)
part.Anchored = true
part.Parent = game.Workspace
local goal = {}
goal.Position = Vector3.new(10, 10, 0)
goal.Color = Color3.new(0, 1, 0)
local tweenInfo = TweenInfo.new(5)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()
Resumo
Propriedades
Propriedade apenas de leitura que aponta para o Instance cujas propriedades estão sendo interpoladas pelo interseção.
Propriedade apenas de leitura que inclui informações sobre como a interpolação do Tween deve ser realizada.
Propriedade apenas de leitura que mostra o estado atual para a animaçõesTween.
Métodos
Métodos herdados de TweenBasePausa a reprodução e redefine as variáveis de transição.Se você então chamar TweenBase:Play(), as propriedades do pré-adolescente retomarão a interpolação em direção ao seu destino, mas levarão a totalidade da duração da animação para fazer isso.
Interrompe a reprodução do interseção.Não redefine suas variáveis de progresso, o que significa que, se você chamar TweenBase:Play(), o pré-adolescente retoma a reprodução a partir do momento em que foi pausado.
Inicia a reprodução de um interseção.Observe que, se a reprodução já tiver começado, chamar Play() não tem efeito a menos que o adolescente tenha terminado ou seja interrompido (por TweenBase:Cancel() ou TweenBase:Pause()).
Eventos
Eventos herdados de TweenBaseIncêndios quando o tween termina de jogar ou quando é interrompido com TweenBase:Cancel() .
Propriedades
Instance
Essa propriedade de um Tween (somente leitura) aponta para o Instance cujas propriedades estão sendo interpoladas.
Amostras de código
This code sample includes a simple function that will return true if the instance of a tween is a Part.
local TweenService = game:GetService("TweenService")
local function isInstanceAPart(tween)
local instance = tween.Instance
return instance:IsA("BasePart")
end
local tweenInfo = TweenInfo.new()
local instance = Instance.new("Part")
local tween = TweenService:Create(instance, tweenInfo, {
Transparency = 1,
})
print(isInstanceAPart(tween))
TweenInfo
Propriedade apenas de leitura que inclui informações sobre como a interpolação do Tween deve ser realizada, usando o digitarde dados TweenInfo.
Amostras de código
An example of the range of different interpolation effects that can be used in Tweens.
-- A TweenInfo with all default parameters
TweenInfo.new()
-- A TweenInfo with its time set to 0.5 seconds.
TweenInfo.new(0.5)
-- A TweenInfo with its easing style set to Back.
TweenInfo.new(0.5, Enum.EasingStyle.Back)
-- A TweenInfo with its easing direction set to In.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In)
-- A TweenInfo that repeats itself 4 times.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4)
-- A TweenInfo that reverses its interpolation after reaching its goal.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4, true)
-- A TweenInfo that loops indefinitely.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, -1, true)
-- A TweenInfo with a delay of 1 second between each interpolation.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4, true, 1)