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

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 apenas de leitura que aponta para o Instance cujas propriedades estão sendo interpoladas pelo interseção.

  • Somente leitura
    Não replicado
    Ler Parallel

    Propriedade apenas de leitura que inclui informações sobre como a interpolação do Tween deve ser realizada.

Propriedades herdados de TweenBase

Métodos

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

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

  • Pause():()

    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.

  • Play():()

    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 TweenBase

Propriedades

Instance

Somente leitura
Não replicado
Ler Parallel

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.

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

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