ScriptDocument | Dokümantasyon - Roblox Yaratıcı Merkezi

local ScriptEditorService = game:GetService("ScriptEditorService")
local Workspace = game:GetService("Workspace")

local newScript = Instance.new("Script")
newScript.Parent = Workspace

local success, err = ScriptEditorService:OpenScriptDocumentAsync(newScript)
if not success then
	warn(`Script belgesini açmada hata: {err}`)
	return
end

local scriptDocument = ScriptEditorService:FindScriptDocument(newScript)
-- Eklentinizle çakışmaması için benzersiz bir neden adı kullanın
scriptDocument:AddReadOnlyReasonsAsync({ "MyPluginReview" })
print(`{scriptDocument.Name} salt okunur: {scriptDocument:IsReadOnly()}`)

CloseAsync

Bekletir

Eklenti Güvenliği

ScriptDocument:CloseAsync():Tuple

Dönüşler

Tuple

Kod Örnekleri

ScriptDocument:CloseAsync

`--!nocheck`

`-- Aşağıdaki kodu Komut Çubuğunda çalıştırın`

local ScriptEditorService = game:GetService("ScriptEditorService")

local documents = ScriptEditorService:GetScriptDocuments()
local scriptDocument
`-- İlk açık script belgesini bul`
for _, document in documents do
	`-- Komut Çubuğu kapatılamaz, bu yüzden onu seçmeyin`
	if not document:IsCommandBar() then
		scriptDocument = document
		break
	end
end

if scriptDocument then
	local success, err = scriptDocument:CloseAsync()
	if success then
		print(`Kapandı {scriptDocument.Name}`)
	else
		warn(`Kapatılamadı {scriptDocument.Name} çünkü: {err}`)
	end
else
	print("Açık script yok")
end

EditTextAsync

Bekletir

Eklenti Güvenliği

ScriptDocument:EditTextAsync(

newText:string, startLine:number, startCharacter:number, endLine:number, endCharacter:number

):Tuple

Parametreler

newText:string

startLine:number

startCharacter:number

endLine:number

endCharacter:number

Dönüşler

Tuple

ForceSetSelectionAsync

Bekletir

Eklenti Güvenliği

ScriptDocument:ForceSetSelectionAsync(

cursorLine:number, cursorCharacter:number, anchorLine:number?, anchorCharacter:number?

):Tuple

Parametreler

cursorLine:number

cursorCharacter:number

anchorLine:number?

Varsayılan değer: nil

anchorCharacter:number?

Varsayılan değer: nil

Dönüşler

Tuple

Kod Örnekleri

ScriptDocument:ForceSetSelectionAsync()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	-- İmlecin mevcut satırındaki metni al
	local cursorLine = scriptDocument:GetSelection()
	local lineText = scriptDocument:GetLine(cursorLine)
	-- Tüm metin satırını zorla seç
	local success, err = scriptDocument:ForceSetSelectionAsync(cursorLine, 1, cursorLine, #lineText + 1)
	if success then
		print("Seçim ayarlandı!")
	else
		print(`Seçimi ayarlamakta başarısız olundu çünkü: {err}`)
	end
else
	print("Açık script yok")
end

GetLine

Eklenti Güvenliği

ScriptDocument:GetLine(lineIndex:number?):string

Parametreler

lineIndex:number?

Varsayılan değer: nil

Dönüşler

string

Kod Örnekleri

ScriptDocument.SeçimDeğişti ve ScriptDocument:GetLine()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	scriptDocument.SelectionChanged:Connect(function(positionLine, positionCharacter, anchorLine, anchorCharacter)
		print(`Seçilen: Satır {positionLine}, Karakter {positionCharacter}`)
		print(`Sabit: Satır {anchorLine}, Karakter {anchorCharacter}`)
		local lineText = scriptDocument:GetLine(positionLine)
		print(`Seçilen satır metni: {lineText}`)
	end)
else
	print("Açık script yok")
end

GetLineCount

Eklenti Güvenliği

ScriptDocument:GetLineCount():number

Dönüşler

number

Kod Örnekleri

ScriptDocument:GetLineCount()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	local lineCount = scriptDocument:GetLineCount()
	print(`Script {lineCount} satır içeriyor!`)
else
	print("Açık script yok")
end

GetReadOnlyReasons

Eklenti Güvenliği

ScriptDocument:GetReadOnlyReasons():{string}

Dönüşler

{string}

Kod Örnekleri

ScriptDocument:GetReadOnlyReasons()

local ScriptEditorService = game:GetService("ScriptEditorService")

for _, document in ScriptEditorService:GetScriptDocuments() do
	local reasons = document:GetReadOnlyReasons()
	if #reasons > 0 then
		print(`{document.Name} yalnızca okunabilir çünkü: {table.concat(reasons, ", ")}`)
	end
end

GetScript

Eklenti Güvenliği

ScriptDocument:GetScript():LuaSourceContainer

Dönüşler

LuaSourceContainer

Kod Örnekleri

ScriptDocument:GetScript()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	local openScript = scriptDocument:GetScript()
	print(`Şu anda açık olan script: {openScript:GetFullName()}`)
else
	print("Açık script yok")
end

GetSelectedText

Eklenti Güvenliği

ScriptDocument:GetSelectedText():string

Dönüşler

string

Kod Örnekleri

ScriptDocument:HasSelectedText() ve :GetSelectedText()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	scriptDocument.SelectionChanged:Connect(function()
		if scriptDocument:HasSelectedText() then
			local selectedText = scriptDocument:GetSelectedText()
			print(`Şu anda seçili metin: {selectedText}`)
		else
			print("Şu anda seçili metin yok")
		end
	end)
else
	print("Açık script yok")
end

GetSelection

Eklenti Güvenliği

ScriptDocument:GetSelection():Tuple

Dönüşler

Tuple

GetSelectionEnd

Eklenti Güvenliği

ScriptDocument:GetSelectionEnd():Tuple

Dönüşler

Tuple

Kod Örnekleri

ScriptDocument:GetSelectionStart() ve :GetSelectionEnd()

--!nocheck

-- Bir script açıkken aşağıdaki kodu Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	local startLine, startCharacter = scriptDocument:GetSelectionStart()
	local endLine, endCharacter = scriptDocument:GetSelectionEnd()
	print(`Seçim başlangıcı: Satır {startLine}, Karakter {startCharacter}`)
	print(`Seçim sonu: Satır {endLine}, Karakter {endCharacter}`)
else
	print("Açık script yok")
end

GetSelectionStart

Eklenti Güvenliği

ScriptDocument:GetSelectionStart():Tuple

Dönüşler

Tuple

Kod Örnekleri

ScriptDocument:GetSelectionStart() ve :GetSelectionEnd()

--!nocheck

-- Bir script açıkken aşağıdaki kodu Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	local startLine, startCharacter = scriptDocument:GetSelectionStart()
	local endLine, endCharacter = scriptDocument:GetSelectionEnd()
	print(`Seçim başlangıcı: Satır {startLine}, Karakter {startCharacter}`)
	print(`Seçim sonu: Satır {endLine}, Karakter {endCharacter}`)
else
	print("Açık script yok")
end

GetText

Eklenti Güvenliği

ScriptDocument:GetText(

startLine:number?, startCharacter:number?, endLine:number?, endCharacter:number?

):string

Parametreler

startLine:number?

Varsayılan değer: nil

startCharacter:number?

Varsayılan değer: nil

endLine:number?

Varsayılan değer: nil

endCharacter:number?

Varsayılan değer: nil

Dönüşler

string

Kod Örnekleri

ScriptDocument:GetText()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	local text = scriptDocument:GetText()
	print(`Script içeriği: {text}`)
else
	print("Açık script yok")
end

GetViewport

Eklenti Güvenliği

ScriptDocument:GetViewport():Tuple

Dönüşler

Tuple

Kod Örnekleri

ScriptDocument:GetViewport

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	local firstLine, lastLine = scriptDocument:GetViewport()
	print(`Şu anda {firstLine} ile {lastLine} arasındaki satırları görüntülüyorsunuz`)
else
	print("Açık script yok")
end

HasSelectedText

Eklenti Güvenliği

ScriptDocument:HasSelectedText():boolean

Dönüşler

boolean

Kod Örnekleri

ScriptDocument:HasSelectedText() ve :GetSelectedText()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	scriptDocument.SelectionChanged:Connect(function()
		if scriptDocument:HasSelectedText() then
			local selectedText = scriptDocument:GetSelectedText()
			print(`Şu anda seçili metin: {selectedText}`)
		else
			print("Şu anda seçili metin yok")
		end
	end)
else
	print("Açık script yok")
end

IsCommandBar

Eklenti Güvenliği

ScriptDocument:IsCommandBar():boolean

Dönüşler

boolean

Kod Örnekleri

ScriptDocument:IsCommandBar()

--!nocheck

-- Aşağıdaki kodu Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local documents = ScriptEditorService:GetScriptDocuments()

for _, document in documents do
	if document:IsCommandBar() then
		print("Komut çubuğu belgesi:", document)
	end
end

IsReadOnly

Eklenti Güvenliği

ScriptDocument:IsReadOnly():boolean

Dönüşler

boolean

Kod Örnekleri

ScriptDocument:IsReadOnly()

local ScriptEditorService = game:GetService("ScriptEditorService")

for _, document in ScriptEditorService:GetScriptDocuments() do
	if document:IsReadOnly() then
		print(`{document.Name} sadece okunur`)
	else
		print(`{document.Name} düzenlenebilir`)
	end
end

MultiEditTextAsync

Bekletir

Eklenti Güvenliği

ScriptDocument:MultiEditTextAsync(edits:{any}):Tuple

Parametreler

edits:{any}

Dönüşler

Tuple

RemoveReadOnlyReasonsAsync

Bekletir

Eklenti Güvenliği

ScriptDocument:RemoveReadOnlyReasonsAsync(reasons:{any}):()

Parametreler

reasons:{any}

Dönüşler

()

Kod Örnekleri

ScriptDocument:RemoveReadOnlyReasonsAsync()

local ScriptEditorService = game:GetService("ScriptEditorService")
local Workspace = game:GetService("Workspace")

local newScript = Instance.new("Script")
newScript.Parent = Workspace

local success, err = ScriptEditorService:OpenScriptDocumentAsync(newScript)
if not success then
	warn(`Script belgesini açmada hata: {err}`)
	return
end

local scriptDocument = ScriptEditorService:FindScriptDocument(newScript)
scriptDocument:AddReadOnlyReasonsAsync({ "MyPluginReview", "MyPluginLocked" })

-- Diğer herhangi bir neden aktifken editör salt okunur kalır
scriptDocument:RemoveReadOnlyReasonsAsync({ "MyPluginReview" })
print(`Bir nedeni kaldırdıktan sonra salt okunur: {scriptDocument:IsReadOnly()}`)

scriptDocument:RemoveReadOnlyReasonsAsync({ "MyPluginLocked" })
print(`Tüm nedenler kaldırıldıktan sonra salt okunur: {scriptDocument:IsReadOnly()}`)

RequestSetSelectionAsync

Bekletir

Eklenti Güvenliği

ScriptDocument:RequestSetSelectionAsync(

cursorLine:number, cursorCharacter:number, anchorLine:number?, anchorCharacter:number?

):Tuple

Parametreler

cursorLine:number

cursorCharacter:number

anchorLine:number?

Varsayılan değer: nil

anchorCharacter:number?

Varsayılan değer: nil

Dönüşler

Tuple

Kod Örnekleri

ScriptDocument:RequestSetSelectionAsync()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	-- İmlecin mevcut satırındaki metni al
	local cursorLine = scriptDocument:GetSelection()
	local lineText = scriptDocument:GetLine(cursorLine)
	-- Tüm metin satırını seçmeyi zorla
	local success, err = scriptDocument:RequestSetSelectionAsync(cursorLine, 1, cursorLine, #lineText + 1)
	if success then
		print("Seçim ayarlandı!")
	else
		print(`Seçimi ayarlamak başarısız oldu çünkü: {err}`)
	end
else
	print("Açık script yok")
end

ReviewableTextEditsAsync

Bekletir

Eklenti Güvenliği

ScriptDocument:ReviewableTextEditsAsync(changes:{any}):Tuple

Parametreler

changes:{any}

Dönüşler

Tuple

Olaylar

SelectionChanged

Eklenti Güvenliği

ScriptDocument.SelectionChanged(

positionLine:number, positionCharacter:number, anchorLine:number, anchorCharacter:number

):RBXScriptSignal

Parametreler

positionLine:number

positionCharacter:number

anchorLine:number

anchorCharacter:number

Kod Örnekleri

ScriptDocument.SeçimDeğişti ve ScriptDocument:GetLine()

--!nocheck

-- Aşağıdaki kodu bir script açıkken Komut Çubuğunda çalıştırın

local ScriptEditorService = game:GetService("ScriptEditorService")

local function getFirstOpenDocument()
	local documents = ScriptEditorService:GetScriptDocuments()
	for _, document in documents do
		if not document:IsCommandBar() then
			return document
		end
	end
	return nil
end

local scriptDocument = getFirstOpenDocument()

if scriptDocument then
	scriptDocument.SelectionChanged:Connect(function(positionLine, positionCharacter, anchorLine, anchorCharacter)
		print(`Seçilen: Satır {positionLine}, Karakter {positionCharacter}`)
		print(`Sabit: Satır {anchorLine}, Karakter {anchorCharacter}`)
		local lineText = scriptDocument:GetLine(positionLine)
		print(`Seçilen satır metni: {lineText}`)
	end)
else
	print("Açık script yok")
end

ViewportChanged

Eklenti Güvenliği

ScriptDocument.ViewportChanged(

startLine:number, endLine:number

):RBXScriptSignal

Parametreler

startLine:number

endLine:number

Kod Örnekleri

ScriptDocument.ViewportChanged'e Bağlanıyor

--!nocheck

--[[
	Çalıştırmak için:
		1. Çıktı görünümünün açık olduğundan emin olun
		2. Aşağıdaki kodu Komut Çubuğunda çalıştırın
		3. Açılan Script penceresinde yukarı ve aşağı kaydırın

	ViewportChanged olayından gelen yazdırma ifadeleri Çıktı'da görünecektir
]]

local Workspace = game:GetService("Workspace")
local ScriptEditorService = game:GetService("ScriptEditorService")

-- Birçok satırı kapsayan metin oluşturun
local dummyText = string.rep("-- Dummy Text\n", 60)

-- Dummy metni içeren bir script oluşturun ve açın
local otherScript = Instance.new("Script")
otherScript.Source = dummyText
otherScript.Parent = Workspace
local success, err = ScriptEditorService:OpenScriptDocumentAsync(otherScript)
if not success then
	warn(`Script açılmadı çünkü: {err}`)
	return
end

-- Açılan script'e bir referans alın
local scriptDocument = ScriptEditorService:FindScriptDocument(otherScript)

local function onViewportChanged(startLine: number, endLine: number)
	print(`Script Görünümü Değişti - başlangıçSatırı: {startLine}, bitişSatırı: {endLine}`)
end
-- Güncellenen görünüm alanının başlangıç ve bitiş satırını yazdıran yukarıdaki fonksiyona ViewportChanged olayını bağlayın
scriptDocument.ViewportChanged:Connect(onViewportChanged)