PluginToolbarButton
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
PluginToolbarButton เป็นวัตถุที่สร้างขึ้นโดย PluginToolbar:CreateButton() ฟังก์ชัน มันช่วยให้ผู้ใช้เริ่มการกระทําเดียวกันใน Roblox Studio ผ่านกิจกรรม Click
เมื่อกด เหตุการณ์ Click จะเกิดขึ้น ปุ่มจะยังคงอยู่ในสถานะที่กดไว้ซึ่ง
เมื่อมุมมองเกมไม่มองเห็นได้ปุ่มจะถูกปิดใช้งานเหมือนกับว่า Enabled คุณสมบัติของพวกเขาเป็นปลอม ปุ่มที่ถูกปิดใช้งานจะถู
สรุป
คุณสมบัติ
กำหนดว่าปุ่มสามารถกดได้เมื่อมุมมองเกมถูกซ่อน เช่นในขณะที่กำลังแก้ไขสคริปต์ในแท็บ Studio อื่น
กำหนดว่าปุ่มนั้นสามารถกดได้ในทั่วไปหรือไม่
กำหนดไอคอนที่เป็นตัวแทนปุ่ม
วิธีการ
ตั้งค่าสถานะปุ่มของปลั๊กอิน
อีเวนต์
เกิดขึ้นเมื่อผู้ใช้กดปุ่มและปล่อยเมาส์ของพวกเขา
คุณสมบัติ
ClickableWhenViewportHidden
คลิกได้เมื่อมุมมองถูกซ่อน กำหนดว่าว่า PluginToolbarButton สามารถคลิกได้เมื่อมุมมองถูกซ่อนไว้ เช่นเมื่อ Script กำลังถูกแก้ไขในแท็บอื่น
โดยทั่วไป, คุณสมบัตินี้เป็นประโยชน์สำหรับการเปิดใช้งานหากเหตุการณ์ Click ของเกมไม่เกิดขึ้นในโลกเกม (Workspace) ตัวอย่างเช่น, ปุ่มที่เปิดโค้ดวิดเ
Enabled
เปิดใช้งาน กำหนดว่าปุ่มนั้นสามารถกดได้ในทั่วไป เมื่อค่านี้เป็นจริง ปุ่มจะถูกเงาขึ้นและไม่สามารถกดได้ ปุ่มเปิดใช้งานโดยปกติ
เมื่อเปิดใช้งานสถานะนี้อีกครั้งปุ่มป้ายชื่อของปลั๊กอินจะไม่ได้รับการจดจำจากสถานะก่อนหน้าที่ผู้ใช้ออกปุ่มในนั้น แทนที่จะเป็นปุ่มป้าย
ปุ่มควรปิดปุ่มเมื่อการกดปุ่มไม่เกี่ยวข้องในบริบทต่อไป เช่น ปุ่มป้ายชื่อสีสันสุ่มที่กำหนดให้กับปุ่มที่เลือกไม่ควรเปิดใช้งานเมื่อการเลือกไม่มีส่วน ดูตัวอย่างโค้ดสำหรับข้อมูลเพิ่มเติม
ดูเพิ่มเติม:
- ClickableWhenViewportHidden ซึ่งกำหนดว่าปุ่มใดที่สามารถกดได้เมื่อมุมมองเกมถูกซ่อน (ท่ัวไป)
ตัวอย่างโค้ด
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
ไอคอน ตรวจสอบว่าสิ่งที่ icon ควรแสดงสำหรับปุ่มในแถบเครื่องมือของปลั๊กอิน เมื่อค่านี้ไม่ได้ตั้งค่าไว้ ปุ่มจะใช้ข้อความของปุ่มที่ให้โดย Class.Plugin
วิธีการ
อีเวนต์
Click
คลิก เปิดเมื่อ PluginToolbarButton ถูกกดและปล่อยโดยผู้ใช้
การคลิก PluginToolbarButton ทำให้สถานะของปุ่มเปลี่ยนแปลง โปรดเรียก SetActive เพื่อการตั้งสถานะปุ่มโดยอัตโนมัติ
ตัวอย่างโค้ด
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)