Tween

Mostrar obsoleto

*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

Tween Creation

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

  • Somente leitura
    Não replicado
    Ler Parallel

    Propriedade de leitura que aponta para o Instance cujas propriedades estão sendo interpoladas pelo interseção.

  • Somente leitura
    Não replicado
    Ler Parallel

    Propriedade de leitura que inclui informações sobre como a interpretação do Tween será realizada.

Propriedades herdados de TweenBase

Métodos

Métodos herdados de TweenBase
  • Cancel():void

    Interrompe 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.

  • Pause():void

    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.

  • Play():void

    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 TweenBase

Propriedades

Instance

Somente leitura
Não replicado
Ler Parallel

A propriedade Instance de um ponto de Tween (somente leitura) aponta para o Instance cujas propriedades estão sendo interpoladas.

Amostras de código

Tween Instance

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

Somente leitura
Não replicado
Ler Parallel

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

TweenInfo Examples

-- 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)

Métodos

Eventos