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. A criação e configuração de um Tween é feita com a função TweenService:Create() ; 2>Datatype.Instance.new()2> não pode ser usado para este Objetoparticular.
Nota que, enquanto a configuração de um tween pode ser acessada depois que um tween for criado, ele não pode ser modificado. Se novos objetivos forem necessários para uma interpolação, um novo Tween deve ser criado.
Nota também que vários tweens podem ser jogados no mesmo objeto ao mesmo tempo, mas eles não devem estar interpolando a mesma propriedade. Se dois tweens tentarem modificar a mesma propriedade, o tween inicial será cancelado e substituído pelo mais recente interseção.
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 de leitura que aponta para o Instance cujas propriedades estão sendo interpoladas pelo interseção.
Propriedade de leitura que inclui informações sobre como a interpretação do Tween será realizada.
Propriedade de leitura que mostra o estado atual para a animaçõesTween.
Métodos
Métodos herdados de TweenBaseInterrompe o playback e redefine as variáveis de tween. Se você então chamar TweenBase:Play(), as propriedades do tween resume a interpolação em direção ao destino, mas leve a longitude completa da animação para fazer isso.
Interrompe o playback do interseção. Não redefine suas variáveis de progresso, o que significa que, se você chamar TweenBase:Play(), o tween retoma o playback do momento em que foi pausado.
Inicia a reprodução de um interseção. Observe que se a reprodução já começou, chamar Play() não tem efeito a menos que o tween tenha terminado ou seja interrompido (por meio de TweenBase:Cancel() ou TweenBase:Pause()).
Eventos
Eventos herdados de TweenBaseDispara quando a música acaba ou quando parado com TweenBase:Cancel() .
Propriedades
Instance
A propriedade Instance de um ponto de 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 de leitura que inclui informações sobre como a interpretação do Tween será realizada, usando o digitarde dado 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)