GuiButton

顯示已棄用項目

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

無法建立
無法瀏覽

GuiButton 是一個繼承自 GuiObject 的抽象類別。

它是可互動、可點擊的 ImageButtonTextButton 物件的基類。這個類別還定義了幾個用於互動行為的屬性,即 AutoButtonColorModal

GuiButton 最重要的事件是 Activated,這是一個 多平台事件,當按鈕被啟用時會觸發。使用滑鼠時,這意味著點擊按鈕並在游標仍在用戶介面物件上方的情況下釋放按鈕。對於觸控,也是同樣的情況,但使用觸控而不是按鈕按下。最後,對於遊戲手把,當按下並釋放 A 按鈕時,Activated 會觸發,前提是選中了 GuiButton。簡而言之,此事件對於多平台用戶介面編程非常有用,因為它為單一用戶輸入提供了一個良好的通用介面。

概要

屬性

屬性 繼承自 GuiObject

屬性

屬性 繼承自 GuiBase2d

屬性

方法

方法 繼承自 GuiObject

方法

活動

活動 繼承自 GuiObject

活動

活動 繼承自 GuiBase2d

活動

屬性

AutoButtonColor

平行讀取

此屬性決定當用戶的 Mouse 懸停或點擊按鈕時,按鈕是否自動改變顏色。如果為 true,當滑鼠懸停在按鈕上或點擊時,按鈕將自動改變顏色。如果為 false,則按鈕不會改變。

如果您想自定義按鈕在用戶滑鼠懸停或點擊時如何變化,請考慮使用 ImageButton,並更改該元素的 HoverImagePressedImage

請注意,如果 ImageButtonImage 屬性設置為一個圖片,則此屬性不會對其產生影響。此外,當其 HoverImage 不為 nil 時,此屬性不會影響 ImageButton 的滑鼠懸停,當其 PressedImage 不為 nil 時也不會影響滑鼠點擊。

HoverHapticEffect

平行讀取

GuiButton 被懸停時將播放的 HapticEffect 實例。

平行讀取

如果在 GUI 元素可見時為 true,則滑鼠不會被鎖定,除非右鍵滑鼠按下。

PressHapticEffect

平行讀取

GuiButton 被按下時將播放的 HapticEffect 實例。

Selected

平行讀取

一個布林值屬性,指示該物件是否已被選中。

平行讀取

根據預先確定的樣式列表設置 GuiButton 的樣式。

方法

活動

Activated

當按鈕被啟用時觸發。由於該事件不會在伺服器上觸發,因此應僅在 LocalScript 中使用,或在 Script 中使用,並且其 RunContext 設置為 Enum.RunContext.Client

參數

inputObject: InputObject
clickCount: number

MouseButton1Click

當用戶的滑鼠完全左鍵單擊 GuiButton 時,該事件會觸發。

關於點擊,滑鼠必須在 GuiButton 的範圍內,且滑鼠按鈕必須按下然後再次釋放,然後該事件才會觸發。如果滑鼠離開 GuiButton 的範圍並釋放了,那麼事件將不會觸發。如果您希望避免這個限制,可以使用 MouseButton1DownMouseButton1Up;這些事件類似,但會在用戶按下或釋放左鍵滑鼠時觸發。


MouseButton1Down

當用戶按下左鍵滑鼠時觸發 GuiButton

對於需要用戶按下 釋放左鍵滑鼠以觸發事件的事件,請考慮使用 MouseButton1Click

參數

滑鼠的 X 螢幕坐標(以像素為單位)。

滑鼠的 Y 螢幕坐標(以像素為單位)。


MouseButton1Up

當用戶在 GuiButton 上釋放左鍵滑鼠時觸發。

對於需要用戶按下 釋放左鍵滑鼠以觸發事件的事件,請考慮使用 MouseButton1Click

參數

滑鼠的 X 螢幕坐標(以像素為單位)。

滑鼠的 Y 螢幕坐標(以像素為單位)。


MouseButton2Click

當用戶的滑鼠完全右鍵單擊 GuiButton 時,該事件會觸發。

關於點擊,滑鼠必須在 GuiButton 的範圍內,且滑鼠按鈕必須按下然後再次釋放,然後該事件才會觸發。如果滑鼠離開 GuiButton 的範圍並釋放了,那麼事件將不會觸發。如果您希望避免這個限制,可以使用 MouseButton2DownMouseButton2Up;這些事件類似,但會在用戶按下或釋放右鍵滑鼠時觸發。


MouseButton2Down

當用戶按下右鍵滑鼠時觸發 GuiButton

對於需要用戶按下 釋放右鍵滑鼠以觸發事件的事件,請考慮使用 MouseButton2Click

參數

滑鼠的 X 螢幕坐標(以像素為單位)。

滑鼠的 Y 螢幕坐標(以像素為單位)。


MouseButton2Up

當用戶釋放右鍵滑鼠時觸發 GuiButton

對於需要用戶按下 釋放右鍵滑鼠以觸發事件的事件,請考慮使用 MouseButton2Click

參數

滑鼠的 X 螢幕坐標(以像素為單位)。

滑鼠的 Y 螢幕坐標(以像素為單位)。