PluginToolbarButton

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ไม่สามารถสร้าง

PluginToolbarButton เป็นวัตถุที่สร้างขึ้นโดย PluginToolbar:CreateButton() ฟังก์ชัน มันช่วยให้ผู้ใช้เริ่มการกระทําเดียวกันใน Roblox Studio ผ่านกิจกรรม Click

เมื่อกด เหตุการณ์ Click จะเกิดขึ้น ปุ่มจะยังคงอยู่ในสถานะที่กดไว้ซึ่ง

เมื่อมุมมองเกมไม่มองเห็นได้ปุ่มจะถูกปิดใช้งานเหมือนกับว่า Enabled คุณสมบัติของพวกเขาเป็นปลอม ปุ่มที่ถูกปิดใช้งานจะถู

สรุป

คุณสมบัติ

  • ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    กำหนดว่าปุ่มสามารถกดได้เมื่อมุมมองเกมถูกซ่อน เช่นในขณะที่กำลังแก้ไขสคริปต์ในแท็บ Studio อื่น

  • ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    กำหนดว่าปุ่มนั้นสามารถกดได้ในทั่วไปหรือไม่

  • Icon:ContentId
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    กำหนดไอคอนที่เป็นตัวแทนปุ่ม

วิธีการ

  • SetActive(active : bool):void
    การรักษาความปลอดภัยของปลั๊กอิน

    ตั้งค่าสถานะปุ่มของปลั๊กอิน

อีเวนต์

  • การรักษาความปลอดภัยของปลั๊กอิน

    เกิดขึ้นเมื่อผู้ใช้กดปุ่มและปล่อยเมาส์ของพวกเขา

คุณสมบัติ

ClickableWhenViewportHidden

ไม่ซ้ำ
อ่านพร้อมๆ กัน

คลิกได้เมื่อมุมมองถูกซ่อน กำหนดว่าว่า PluginToolbarButton สามารถคลิกได้เมื่อมุมมองถูกซ่อนไว้ เช่นเมื่อ Script กำลังถูกแก้ไขในแท็บอื่น

โดยทั่วไป, คุณสมบัตินี้เป็นประโยชน์สำหรับการเปิดใช้งานหากเหตุการณ์ Click ของเกมไม่เกิดขึ้นในโลกเกม (Workspace) ตัวอย่างเช่น, ปุ่มที่เปิดโค้ดวิดเ

Enabled

ไม่ซ้ำ
อ่านพร้อมๆ กัน

เปิดใช้งาน กำหนดว่าปุ่มนั้นสามารถกดได้ในทั่วไป เมื่อค่านี้เป็นจริง ปุ่มจะถูกเงาขึ้นและไม่สามารถกดได้ ปุ่มเปิดใช้งานโดยปกติ

เมื่อเปิดใช้งานสถานะนี้อีกครั้งปุ่มป้ายชื่อของปลั๊กอินจะไม่ได้รับการจดจำจากสถานะก่อนหน้าที่ผู้ใช้ออกปุ่มในนั้น แทนที่จะเป็นปุ่มป้าย

ปุ่มควรปิดปุ่มเมื่อการกดปุ่มไม่เกี่ยวข้องในบริบทต่อไป เช่น ปุ่มป้ายชื่อสีสันสุ่มที่กำหนดให้กับปุ่มที่เลือกไม่ควรเปิดใช้งานเมื่อการเลือกไม่มีส่วน ดูตัวอย่างโค้ดสำหรับข้อมูลเพิ่มเติม

ดูเพิ่มเติม:

  • ClickableWhenViewportHidden ซึ่งกำหนดว่าปุ่มใดที่สามารถกดได้เมื่อมุมมองเกมถูกซ่อน (ท่ัวไป)

ตัวอย่างโค้ด

BrickColor Randomizer Plugin

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

ContentId
ไม่ซ้ำ
อ่านพร้อมๆ กัน

ไอคอน ตรวจสอบว่าสิ่งที่ icon ควรแสดงสำหรับปุ่มในแถบเครื่องมือของปลั๊กอิน เมื่อค่านี้ไม่ได้ตั้งค่าไว้ ปุ่มจะใช้ข้อความของปุ่มที่ให้โดย Class.Plugin

วิธีการ

SetActive

void
การรักษาความปลอดภัยของปลั๊กอิน

วิธีนี้สามารถใช้เพื่อตั้งค่าสถานะที่ใช้งานได้ของปุ่มปลั๊กอิน

เมื่อสถานะ Enabled ถูกเปิดกลับมาเป็นค่าเริ่มต้น ปุ่มจะกลับสู่สถานะล่าสุดที่กำหนดโดยวิธีนี้หรือปกติหากวิธีนี้ไม่ได้ถูกใช้มาก่อน

พารามิเตอร์

active: bool

ส่งค่ากลับ

void

อีเวนต์

Click

การรักษาความปลอดภัยของปลั๊กอิน

คลิก เปิดเมื่อ PluginToolbarButton ถูกกดและปล่อยโดยผู้ใช้

การคลิก PluginToolbarButton ทำให้สถานะของปุ่มเปลี่ยนแปลง โปรดเรียก SetActive เพื่อการตั้งสถานะปุ่มโดยอัตโนมัติ


ตัวอย่างโค้ด

PluginToolbarButton.Click

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)