PluginToolbarButton
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Bir PluginToolbarButton, PluginToolbar:CreateButton() fonksiyonu tarafından oluşturulan bir nesnedir.Kullanıcının Roblox Studio'daki tek, tek bir eylemi başlatmasına izin verir Click etkinliği aracılığıyla.
Basıldığında, Click etkinliği ateşlenir.Bir düğme de basılmış durumda kalacak ve bunun manuel olarak ayarlanması için SetActive kullanılabilir.Eklenti etkinleştirildiğinde ( Plugin:Activate() ), diğer tüm PluginToolbars düğmeler kapatılacaktır.Bir araç çubuğundaki tüm düğmeler kapalıysa, araç çubuğunun eklentisi devre dışı kalır ( Plugin:Deactivate() ).
Oyun görünüm penceresi görünmez olduğunda, düğmeler sahte gibi devre dışı bırakılır, çünkü Enabled özellikleri yanlıştır.Devre dışı bırakılan düğmeler renksizdir ve kullanıcı tıklamalarına yanıt vermez.ClickableWhenViewportHidden true olarak ayarlayarak, plugin düğmelerinin (örneğin, senaryo düzenlenirken) tıklanabilir kalmasına izin verebilirsiniz.
Özet
Özellikler
Butonun, oyun görüntüsü gizlendiğinde tıklanabilir olup olmadığını belirler, örneğin farklı bir Stüdyo sekizinde bir senaryoyu düzenlerken.
Butonun genel olarak tıklanabilir olup olmadığını belirler.
Butonu temsil eden simgenin ne olması gerektiğini belirler.
Yöntemler
Plug-in düğmesinin durumunu ayarlar.
Etkinlikler
Kullanıcı düğmeye basıp serbest bıraktığında ateş eder. Fires when the user presses and releases their cursor on the button.
Özellikler
ClickableWhenViewportHidden
Görüntüleme Penceresi Gizli Olduğunda Tıklanabilir bir PluginToolbarButonunun, oyun görüntüleme penceresi gizlendiğinde tıklanıp tıklanmayacağını belirler, örneğin bir Script başka bir sekmede düzenlenirken.
Genellikle, bu özellik, bir plugin düğmesinin Click etkinliği tarafından tetiklenen bir eylemin oyun dünyasında (Çalışma Alanı) gerçekleşmediği durumda etkinleştirilmesi için iyidir.Örneğin, bir widget'i açan bir düğme, oyun görünümü görünür olmasa bile kullanıcı için görünür olması gereken bu özelliğe sahip olmalıdır, çünkü oyun görünümü görünür olmasa bile bir widget açılır.
Enabled
Etkinleştirildi genel olarak bir düğmeye tıklanabilir olup olmadığını belirler.Bu özellik yanlış olduğunda, düğme grileşecek ve tıklanamayacak, kullanıcının Click etkinliğini ateşlemesini engelleyecektir.Butonlar varsayılan olarak etkinleştirilir.
Bu özelliği yeniden etkinleştirirken, kullanıcı düğmeyi terk ettiği önceki durumdan plugin düğmesinin durumu hatırlanmayacaktır.Bunun yerine, varsayılan son durum tarafından ayarlanacak veya hiç kullanılmadıysa aktif olmayan durum.
Eklentiler, düğme eylemi mevcut kontekste önemli olmadığında düğmelerini devre dışı bırakmalıdır.Örneğin, seçilmiş olanlara rastgele renkler atayan bir plugin düğmesi, seçimde parça bulunmadığında etkinleştirilmemelidir.Daha fazla bilgi için kod örneklerine bakın.
Ayrıca bakın:
- ClickableWhenViewportHidden , oyun görüntüsü gizlendiğinde bir düğmeye tıklanıp tıklanmayacağını belirleyen (ve sadece genel olarak değil)
Kod Örnekleri
This code sample is for a studio Plugin. The plugin creates a PluginToolbarButton which randomizes the BrickColor() of each selected part using BrickColor.random(). Furthermore, the button is only enabled if at least one part is selected. It does this by detecting changes in the Selection using Selection.SelectionChanged.
assert(plugin, "This script must be run as a plugin")
local Selection = game:GetService("Selection")
local toolbar = plugin:CreateToolbar("Parts")
local pluginToolbarButton = toolbar:CreateButton(
"Randomize Colors",
"Click this button to assign random colors to selected parts",
"rbxassetid://5325741572" -- A rainbow
)
local function onClick()
local selection = Selection:Get()
for _, object in pairs(selection) do
if object:IsA("BasePart") then
object.BrickColor = BrickColor.random()
end
end
end
pluginToolbarButton.Click:Connect(onClick)
local function doesSelectionContainAPart()
local selection = Selection:Get()
for _, object in pairs(selection) do
if object:IsA("BasePart") then
return true
end
end
return false
end
local function onSelectionChanged()
pluginToolbarButton.Enabled = doesSelectionContainAPart()
end
Selection.SelectionChanged:Connect(onSelectionChanged)
onSelectionChanged()Icon
Simge , plugin arayüz çubuğundaki düğme için ne gösterilmesi gerektiğini belirler.Bu özellik ayarlanmadığında, düğme yerine düğmenin verdiği metni kullanacaktır PluginToolbar:CreateButton() .
Yöntemler
SetActive
Bu yöntem, eklenti düğmesinin aktif durumunu manuel olarak ayarlamak için kullanılabilir.
Enabled özelliği geri döndürüldüğünde, düğme ya bu yöntem tarafından belirlenen son duruma geri döner ya da önceden kullanılmadıysa varsayılan olarak aktif değildir.
Parametreler
Dönüşler
Etkinlikler
Click
Tıklama düğmesi basıldığında ve kullanıcı tarafından serbest bırakıldığında PluginToolbarButton tarafından ateşlenir.
Bir PluginToolbarButonuna tıklamak, düğmenin durumunu değiştirir. Butonun durumunu manuel olarak ayarlamak için SetActive 'yi arayın.
Kod Örnekleri
This code sample demonstrates creating a PluginToolbar and a PluginToolbarButton on it, then connecting a function onClick to the PluginToolbarButton.Click event. When pressed, the button will print "Hello, world" to the output.
assert(plugin, "This script must be run as a plugin")
local toolbar = plugin:CreateToolbar("Hello World Plugin Toolbar")
local pluginToolbarButton =
toolbar:CreateButton("Print Hello World", "Click this button to print Hello World!", "rbxassetid://133293265")
local function onClick()
print("Hello, world")
end
pluginToolbarButton.Click:Connect(onClick)