Classe do mecanismo
ChangeHistoryService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Resumo
Métodos
FinishRecording(identifier: string,operation: Enum.FinishRecordingOperation,finalOptions: Dictionary?):() |
IsRecordingInProgress(identifier: string?):boolean |
Redo():() |
ResetWaypoints():() |
SetEnabled(state: boolean):() |
SetWaypoint(name: string):() |
TryBeginRecording(name: string,displayName: string?):string? |
Undo():() |
Eventos
OnRecordingFinished(name: string,displayName: string?,identifier: string?,operation: Enum.FinishRecordingOperation,finalOptions: Dictionary?):RBXScriptSignal |
OnRecordingStarted(name: string,displayName: string?):RBXScriptSignal |
OnRedo(waypoint: string):RBXScriptSignal |
OnUndo(waypoint: string):RBXScriptSignal |
Referência API
Métodos
FinishRecording
ChangeHistoryService:FinishRecording(
):()
Parâmetros
Devolução
()
Amostras de código
ChangeHistoryService:TryBeginRecording
local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")
local toolbar = plugin:CreateToolbar("Exemplo de Plugin")
local button = toolbar:CreateButton("Neonize", "", "")
button.Click:Connect(function()
local parts = {}
for _, part in pairs(Selection:Get()) do
if part:IsA("BasePart") then
parts[#parts + 1] = part
end
end
if #parts < 1 then
-- Nada a fazer.
return
end
local recording = ChangeHistoryService:TryBeginRecording("Definir seleção para neon")
if not recording then
-- Lidar com o erro aqui. Isso indica que seu plugin começou um registro anterior
-- e nunca o completou. Você pode ter apenas um registro
-- por plugin ativo de cada vez.
return
end
for _, part in pairs(parts) do
part.Material = Enum.Material.Neon
end
ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)IsRecordingInProgress
Redo
ChangeHistoryService:Redo():()
Devolução
()
ResetWaypoints
ChangeHistoryService:ResetWaypoints():()
Devolução
()
SetWaypoint
Parâmetros
Devolução
()
Amostras de código
Serviço de Histórico de Mudanças:DefinirPontoDeVista
local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")
local toolbar = plugin:CreateToolbar("Exemplo de Plugin")
local button = toolbar:CreateButton("Neonize", "", "")
button.Click:Connect(function()
local parts = {}
for _, part in pairs(Selection:Get()) do
if part:IsA("BasePart") then
parts[#parts + 1] = part
end
end
if #parts > 0 then
-- Chamar DefinirPontoDeVista antes do trabalho não causará problemas, no entanto
-- é redundante, apenas a chamada DEPOIS do trabalho é necessária.
--ChangeHistoryService:SetWaypoint("Definindo seleção para neon")
for _, part in pairs(parts) do
part.Material = Enum.Material.Neon
end
-- Chame DefinirPontoDeVista DEPOIS de completar o trabalho
ChangeHistoryService:SetWaypoint("Definir seleção para neon")
else
-- Nada a fazer. Você não precisa chamar DefinirPontoDeVista no caso em que
-- a ação não acabou fazendo nenhuma alteração na experiência.
end
end)TryBeginRecording
Devolução
Amostras de código
ChangeHistoryService:TryBeginRecording
local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")
local toolbar = plugin:CreateToolbar("Exemplo de Plugin")
local button = toolbar:CreateButton("Neonize", "", "")
button.Click:Connect(function()
local parts = {}
for _, part in pairs(Selection:Get()) do
if part:IsA("BasePart") then
parts[#parts + 1] = part
end
end
if #parts < 1 then
-- Nada a fazer.
return
end
local recording = ChangeHistoryService:TryBeginRecording("Definir seleção para neon")
if not recording then
-- Lidar com o erro aqui. Isso indica que seu plugin começou um registro anterior
-- e nunca o completou. Você pode ter apenas um registro
-- por plugin ativo de cada vez.
return
end
for _, part in pairs(parts) do
part.Material = Enum.Material.Neon
end
ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)Undo
ChangeHistoryService:Undo():()
Devolução
()
Eventos
OnRecordingFinished
ChangeHistoryService.OnRecordingFinished(
name:string, displayName:string?, identifier:string?, operation:Enum.FinishRecordingOperation, finalOptions:Dictionary?
Parâmetros
OnRecordingStarted