GuiButton

顯示已棄用項目

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

無法建立
無法瀏覽

GuiButton 是一個抽象類別,從 GuiObject 繼承。它是互動、可點擊的 ImageButtonTextButton 對象的基礎類。此類也定義了幾個互動行為的屬性,即 AutoButtonColorModal

GuiButton 中最重要的事件是 Activated , 一個 多平台事件 ,當按鈕啟用時發生。當使用滑鼠時,這意味著單擊按鈕並將鼠標釋放在 UI 對象上仍然是按住的狀態。對於觸碰,同樣適用,但使用觸碰而不是按鍵操作。最後,對於遊戲手柄,Activated在按下和釋放GuiButton按鈕時,如果選擇了 **** ,將發生火災。總之,這個事件對於多平台使用者介面程序化非常有用,因為它為單一使用者輸入提供了一個很好的通用介面。

概要

屬性

屬性 繼承自 GuiObject屬性 繼承自 GuiBase2d

方法

方法 繼承自 GuiObject

活動

活動 繼承自 GuiObject活動 繼承自 GuiBase2d

屬性

AutoButtonColor

平行讀取

此屬性決定是否當使用者的 Mouse 將鼠標懸停或單擊時,按鈕會自動變更顏色。如果 true , 按鈕會在滑鼠停止在上面或單擊時自動變更顏色。如果 false , 按鈕不會變更。

如果您想自定义用戶的鼠標漂浮或單擊按鈕時按鈕的變化方式,考慮使用 ImageButton 並修改元素的 HoverImagePressedImage

請注意,此屬性將不會對 ImageButton 有影響,如果其 Image 屬性設為圖像。此外,此屬性不會影響在其 不是 時的滑鼠漂浮,也不會影響滑鼠點擊時其 不是 。

HoverHapticEffect

平行讀取

一個 HapticEffect 會在 GuiButton 被掃過時播放的實例。

平行讀取

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

PressHapticEffect

平行讀取

一個會在 HapticEffect 按下時播放的實例,當 GuiButton 被按下時。

Selected

平行讀取

一個指示對象是否已被選擇的 boolean 屬性。

平行讀取

根據一個預定義的 сти列設置 GuiButton 的風格。

方法

活動

Activated

當按鈕啟用時發生火災。由於此事件不會在伺服器上發生,因此只能在 LocalScriptScript 使用 RunContextEnum.RunContext.Client 中使用。

參數

inputObject: InputObject
clickCount: number

MouseButton1Click

當使用者的滑鼠完全點擊 GuiButton 時,此事件發生。

在點擊方面,滑鼠必須在 GuiButton 的範圍內,滑鼠按鈕必須壓下並再次向上壓下,才能在此事件發生前。如果滑鼠離開 GuiButton 的範圍並被釋放,事件將不會發觸發。如果您想避免這種限制,您可以使用 MouseButton1DownMouseButton1Up;這些事件相似,但會在使用者按下左滑鼠按鈕向下或向上時發射,分別稱為「向下」和「向上」。


MouseButton1Down

當使用者按下左滑鼠按鈕時,此事件會在 GuiButton 上發生。

對於需要用戶按下 釋放左滑鼠在 GuiButton 以啟動事件的事件,請考慮使用 MouseButton1Click

參數

滑鼠標的 X 畫面坐標以像素計算。

滑鼠的 Y 畫面坐標以像素為單位。


MouseButton1Up

當使用者釋放左滑鼠按鈕時,此事件會發生在 GuiButton 上。

對於需要用戶按下 釋放左滑鼠在 GuiButton 以啟動事件的事件,請考慮使用 MouseButton1Click

參數

滑鼠標的 X 畫面坐標以像素計算。

滑鼠的 Y 畫面坐標以像素為單位。


MouseButton2Click

此事件發生時,使用者的滑鼠完全右鍵單擊 GuiButton

在點擊方面,滑鼠必須在 GuiButton 的範圍內,滑鼠按鈕必須壓下並再次向上壓下,才能在此事件發生前。如果滑鼠離開 GuiButton 的範圍並被釋放,事件將不會發觸發。如果您想避免這種限制,您可以使用 MouseButton2DownMouseButton2Up;這些事件相似,但會在使用者按下右鍵或向上鍵時發射,分別依次。


MouseButton2Down

當使用者按下右滑鼠按鈕時,此事件會在 GuiButton 上發生。

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

參數

滑鼠標的 X 畫面坐標以像素計算。

滑鼠的 Y 畫面坐標以像素為單位。


MouseButton2Up

當使用者釋放右滑鼠按鈕時,此事件會發生在 GuiButton 上。

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

參數

滑鼠標的 X 畫面坐標以像素計算。

滑鼠的 Y 畫面坐標以像素為單位。