GuiButton

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

無法建立
無法瀏覽

GUIButton 是從 GuiObject 繼承的抽象類。它是 ImageButton 和 Class.TextButton

Class.GuiButton.Activated 是按鈕啟動時發生的 多平台事件 ，當按鈕啟動時發生時，按鈕將會釋按下。GuiButton.Activated時，這意

概要

屬性

  • AutoButtonColor:bool
    平行讀取

    決定是否在滑鼠悠閒時自動變更按鈕的顏色。

  • Modal:bool
    平行讀取

    如果 GUI 元素可見，否則鼠標將不會鎖定，除非右鍵已按下。

  • Selected:bool
    平行讀取

    一個Boolean 屬性，表示對象是否已選擇。

  • Style:Enum.ButtonStyle
    平行讀取

    設定按鈕按鈕的造型，以基於預設造型的列表。

屬性 繼承自 GuiObject屬性 繼承自 GuiBase2d
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

方法

方法 繼承自 GuiObject
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

活動

活動 繼承自 GuiObject活動 繼承自 GuiBase2d
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

屬性

AutoButtonColor

bool
平行讀取

自動按鈕顏色將會在使用者的 Mouse 懸停或點擊時自動變更顏色。

如果是，按鈕會在滑鼠移動到或點擊時自動變更顏色。 如果是，按鈕不會變更。

如果您想自訂按鈕在用戶的滑鼠悠閒時或點擊時變更時的方式，請考慮使用 ImageButton GUI 並改變元素的 ImageButton.HoverImage 和 ImageButton.PressedImage。

請注意，此屬性對 ImageButton 沒有效果，如果它的屬性設為圖像，並且不是 null。此外，此屬性對於 4> Class.ImageButton.HoverImage4> 在鍵盤上按下時，它的 7> Class.ImageButton.PressedImage7>

範例程式碼

The code below enables a button's GuiButton.AutoButtonColor as long as it it not a ImageButton with ImageButton.HoverImage and ImageButton.PressedImage properties set to images.

In order for the code to work as expected, it must be placed in a LocalScript that is a child of the button.

Changing a GUI Button's Color on Hover and Click
local button = script.Parent



if button:IsA("ImageButton") then

	if button.HoverImage and button.ClickImage then

		return

	end

end



button.AutoButtonColor = true
bool
平行讀取

如果 GUI 元素可見，否則鼠標將不會鎖定，除非右鍵已按下。

Selected

bool
平行讀取

一個Boolean 屬性，表示對象是否已選擇。

Style

Enum.ButtonStyle
平行讀取

設定按鈕按鈕的造型，以基於預設造型的列表。

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

方法

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

活動

Activated

按鈕啟用時發射。這個事件不會在服務伺服器上發射，因此它只能在 LocalScript 或 Script 中使用，並且只有 RunContext 的 2>Class.Script.RunContext2> 使用。

參數

inputObject: InputObject
clickCount: number

MouseButton1Click

MouseButton1Click 事件發生，當使用者的 Mouse 完全左鍵時按一下 GUI 按鈕。

通過點擊，鼠標必須位於按鈕的範圍內，並且必須再次按下和上升才能發生此事件。如果鼠標離開按鈕的範圍，並且被釋放，則事件將不會發觸發。如果您想避免此限制，您可以使用 GuiButton.MouseButton1Down 和 MouseButton

這個事件與 GuiButton.MouseButton2Click 相似，但與它們相同，因為它們連接到使用者的右鍵。

注意，此事件只有按鈕，包括 TextButtons 和 ImageButton 。它不會發射其他 GuiObjects 。


範例程式碼

The code sample below demonstrates how to use the GuiButton.MouseButton1Click and GuiButton.MouseButton2Click events to handle user left and right mouse button input on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling User Clicks on a GUI Button
local button = script.Parent



local function leftClick()

	print("Left mouse click")

end



local function rightClick()

	print("Right mouse click")

end



button.MouseButton1Click:Connect(leftClick)

button.MouseButton2Click:Connect(rightClick)

MouseButton1Down

MouseButton1Down 事件發生，當使用者按下 GUI 對象上的左 Mouse 按物件。

這個事件與 GuiButton.MouseButton2Down 相似，但它與用戶的右鍵儲存按鈕相同，只是連接到用戶的右鍵儲存按鈕。

如果您正在尋找需要用戶按下並釋放左鍵以發觸發事件的事件，請考慮使用 GuiButton.MouseButton1Click 。

注意，此事件只有按鈕，包括 TextButtons 和 ImageButton 。它不會發射其他 GuiObjects 。

參數

x: number

滑鼠的 x 畫面坐標在像素。

y: number

滑鼠的 y 螢幕坐標在像素。


範例程式碼

The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Right Mouse Button Up/Down on a GUI Button
local button = script.Parent



local function leftMouseButtonUp(x, y)

	print("Left mouse up at", x, y)

end



local function leftMouseButtonDown(x, y)

	print("Left mouse down at", x, y)

end



button.MouseButton1Up:Connect(leftMouseButtonUp)

button.MouseButton1Down:Connect(leftMouseButtonDown)

MouseButton1Up

MouseButton1Up 事件會在使用者釋放左側 Mouse 時發生。

這個事件與 GuiButton.MouseButton2Up 相似，但它與用戶的右鍵相連，以外的行為相同。

如果您正在尋找需要用戶按下並釋放左鍵以發觸發事件的事件，請考慮使用 GuiButton.MouseButton1Click 。

注意，此事件只有按鈕，包括 TextButtons 和 ImageButton 。它不會發射其他 GuiObjects 。

參數

x: number

滑鼠的 x 畫面坐標在像素。

y: number

滑鼠的 y 螢幕坐標在像素。


範例程式碼

The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Right Mouse Button Up/Down on a GUI Button
local button = script.Parent



local function leftMouseButtonUp(x, y)

	print("Left mouse up at", x, y)

end



local function leftMouseButtonDown(x, y)

	print("Left mouse down at", x, y)

end



button.MouseButton1Up:Connect(leftMouseButtonUp)

button.MouseButton1Down:Connect(leftMouseButtonDown)

MouseButton2Click

滑鼠按鈕2Click事件發生，當使用者的 Mouse 完全右鍵點擊GUI按鈕時。

通過點擊，鼠標必須位於按鈕的範圍內，並且必須再次按下和上升才能發生此事件。如果鼠標離開按鈕的範圍，並且被釋放，則事件將不會發觸發。如果您想避免此限制，您可以使用 GuiButton.MouseButton2Down 和 MouseButton

這個事件與 GuiButton.MouseButton1Click 相似，但與它們相同，因為它們連接到用戶的左鍵。

注意，此事件只有按鈕，包括 TextButtons 和 ImageButton 。它不會發射其他 GuiObjects 。


範例程式碼

Demonstrates how to use the GuiButton.MouseButton2Click event to detect when a user right clicks a GuiButton.

The mouse has to be in bounds of the button and has to be pressed down and up again before this event fires.

Note: place the "RightClickScreenGui" within StarterGui for this sample to work properly.

GUI Button Right Click
local button = script.Parent.Button



local function rightClick()

	print("Right click pressed down and up on button.")

end



button.MouseButton2Click:Connect(rightClick)

MouseButton2Down

滑鼠按鈕2下事件發生，當使用者按下滑鼠按鈕2下對象上的Mouse按物件。

這個事件與 GuiButton.MouseButton1Down 相似，但它與用戶的左鍵卻相同，因為它連接到用戶的左鍵按鈕。

如果您正在尋找需要使用者按下並釋放右鍵以發觸發事件的事件，請考慮使用 GuiButton.MouseButton2Click 。

注意，此事件只有按鈕，包括 TextButtons 和 ImageButton 。它不會發射其他 GuiObjects 。

參數

x: number

滑鼠的 x 畫面坐標在像素。

y: number

滑鼠的 y 螢幕坐標在像素。


範例程式碼

The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Left Mouse Button Up/Down on a GUI Button
local gui = script.Parent

local button = gui.Button



function rightMouseButtonUp(x, y)

	print("Right mouse up", x, y)

end



function rightMouseButtonDown(x, y)

	print("Right mouse down", x, y)

end



button.MouseButton2Up:Connect(rightMouseButtonUp)

button.MouseButton2Down:Connect(rightMouseButtonDown)

MouseButton2Up

MouseButton2Up 事件會在使用者釋放右鍵 Mouse 以外的 GUI 對物件時發生。

這個事件與 GuiButton.MouseButton1Up 相似，但它與用戶的左鍵卻相同，因為它連接到用戶的左鍵按鈕。

如果您正在尋找需要使用者按下並釋放右鍵以發觸發事件的事件，請考慮使用 GuiButton.MouseButton2Click 。

注意，此事件只有按鈕，包括 TextButtons 和 ImageButton 。它不會發射其他 GuiObjects 。

參數

x: number

滑鼠的 x 畫面坐標在像素。

y: number

滑鼠的 y 螢幕坐標在像素。


範例程式碼

The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Left Mouse Button Up/Down on a GUI Button
local gui = script.Parent

local button = gui.Button



function rightMouseButtonUp(x, y)

	print("Right mouse up", x, y)

end



function rightMouseButtonDown(x, y)

	print("Right mouse down", x, y)

end



button.MouseButton2Up:Connect(rightMouseButtonUp)

button.MouseButton2Down:Connect(rightMouseButtonDown)
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目