文字與圖片按鈕

GuiButtons 是 GuiObjects，允許玩家執行一個動作。您可以自訂這些按鈕以提供上下文和反饋，例如在玩家與按鈕互動時改變視覺外觀或 腳本 聲音反饋。

您可以放置兩種類型的按鈕 在螢幕上 或 在遊戲中：

• TextButton 是一個帶有文字的矩形，點擊/輕觸時觸發 Activated 和/或 SecondaryActivated 事件。

• ImageButton 是一個帶有圖片的矩形，點擊/輕觸時觸發 Activated 和/或 SecondaryActivated 事件。它具有額外的狀態，用於在玩家懸停或按壓時更換圖片。

螢幕上的按鈕

螢幕上的按鈕 在螢幕上 對於快速引導玩家到各種菜單或頁面非常有用。要添加這種類型的按鈕：

1. 在 Explorer 窗口中，將滑鼠懸停在 StarterGui 上，點擊 ⊕ 按鈕，並插入一個 ScreenGui。

2. 將滑鼠懸停在新的 ScreenGui 上，點擊 ⊕ 按鈕，並插入一個 TextButton 或 ImageButton。

   

零件面上的按鈕

零件上的按鈕對於允許玩家與零件互動非常有用。例如，您可以讓玩家踩在按鈕上以完成一個動作。

要將按鈕添加到零件的面上：

1. 在 Explorer 窗口中，將滑鼠懸停在 零件 上，點擊 ⊕ 按鈕，並插入一個 SurfaceGui。

2. 將滑鼠懸停在新的 SurfaceGui 上，點擊 ⊕ 按鈕，並插入一個 TextButton 或 ImageButton。

   

   如果您看不到按鈕，請嘗試為 Face 屬性選擇不同的面 (Top、Bottom、Front、Back、Left 或 Right)。

按鈕外觀

TextButton 和 ImageButton 都繼承自 GuiObject，該類別包含像 BackgroundColor3、Rotation 和 Size 等屬性。按鈕還接受大多數 UI 物件的 外觀修飾符。

TextButton 特有的各種屬性可用於改變其視覺外觀：

• FontFace — 用於渲染文字的字型。
• Text — 在按鈕上渲染的文字字串。
• TextSize — 文字的行高，以偏移量表示。
• TextColor3 — 渲染文字的顏色。

ImageButton 有幾個屬性可用於改變其視覺外觀，包括懸停和按壓的圖片變體，以指示玩家與按鈕的互動：

• Image — 玩家未與 ImageButton 互動時顯示的圖片。
• HoverImage — 玩家將游標懸停在 ImageButton 上時顯示的圖片。
• PressedImage — 玩家點擊/輕觸 ImageButton 時顯示的圖片。

腳本按鈕

您可以通過將按鈕連接到 GuiButton.Activated 事件來編寫當玩家按下按鈕時的動作，或者對於跨平台的次要輸入（例如桌面上的右鍵單擊和移動設備上的長按），連接到 GuiButton.SecondaryActivated。例如，當您將以下 LocalScript 作為按鈕的父級時，每當玩家點擊/輕觸它，按鈕就會變成隨機顏色。

local button = script.Parent
local RNG = Random.new()

local function onButtonActivated()
	-- 隨機化按鈕顏色
	button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end

button.Activated:Connect(onButtonActivated)