GuiButton 是一個抽象類別,從 GuiObject 繼承。它是互動、可點擊的 ImageButton 和 TextButton 對象的基礎類。此類也定義了幾個互動行為的屬性,即 AutoButtonColor 和 Modal 。
在 GuiButton 中最重要的事件是 Activated , 一個 多平台事件 ,當按鈕啟用時發生。當使用滑鼠時,這意味著單擊按鈕並將鼠標釋放在 UI 對象上仍然是按住的狀態。對於觸碰,同樣適用,但使用觸碰而不是按鍵操作。最後,對於遊戲手柄,Activated在按下和釋放GuiButton按鈕時,如果選擇了 **** ,將發生火災。總之,這個事件對於多平台使用者介面程序化非常有用,因為它為單一使用者輸入提供了一個很好的通用介面。
概要
屬性
決定按鈕在滑鼠停止或單擊時是否自動變更顏色。
一個 HapticEffect 會在 GuiButton 被掃過時播放的實例。
如果 true 在GUI元素可見時,鼠標不會被鎖定,除非右鍵按下。
一個會在 HapticEffect 按下時播放的實例,當 GuiButton 被按下時。
一個指示對象是否已被選擇的 boolean 屬性。
根據一個預定義的 сти列設置 GuiButton 的風格。
決定這個介面元素是否會沉沒輸入。
決定 GuiObject 的起始點,相對於其絕對尺寸。
決定是否基於兒童內容進行縮放。
決定 GuiObject 背景顏色。
決定 GuiObject 背景和邊框的透明度。
決定 GuiObject 邊框的顏色。
決定在哪種方式下 GuiObject 邊界被布置在其尺寸相對。
決定 GuiObject 邊框的像素寬度。
決定是否在父 GUI 元素的範圍之外成像子元素 GuiObjects 。
決定玩家的鼠標是否在 GuiObject 上被主動按下。
控制使用 GuiObject 與 UIGridStyleLayout 時的排序順序。
設置在遊戲控制器選擇器向下移動時會選擇的 GuiObject 。
設置在遊戲控制器選擇器移動到左側時會選擇的 GuiObject 。
設置在遊戲控制器選擇器移動到右側時會選擇的 GuiObject 。
設置在遊戲控制器選擇器向上移動時會選擇的 GuiObject 。
決定 GuiObject 的像素和向量位置。
決定旋轉 GuiObject 的角度數量。
確定是否可以由遊戲控制器選擇 GuiObject 。
覆蓋使用於遊戲板的預設選擇裝飾。
由遊戲控制器介面選擇所選擇的 GuiObjects 順序。
決定 GuiObject 的像素和積分尺寸。
混合屬性 BackgroundTransparency 和 TextTransparency 。
決定是否渲染 GuiObject 和其子孫。
決定 GuiObject 對其他人的相對順序進行渲染。
方法
方法 繼承自 GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
順暢將 GUI 移動到新的 UDim2 。
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
順暢將 GUI 移動到新的尺寸和位置。
活動
當按鈕啟用時發生火災。
當使用者的滑鼠完全點擊 GuiButton 時發生火災。
當使用者按下左滑鼠按鈕時,在 GuiButton 上發生火災。
當使用者釋放左滑鼠按鈕時,發生在 GuiButton 上。
當使用者的滑鼠完全右鍵單擊 GuiButton 時發生火災。
當使用者按下右鍵時,在 GuiButton 上按下滑鼠右鍵。
當使用者釋放右滑鼠按鈕時,發生火災 GuiButton 。
當使用者開始使用人工智慧與電腦介面裝置(例如滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等)時發射。
當使用者變更如何透過人工智慧與電腦介面裝置(滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等)進行互動時,發射時間。
當使用者停止使用人工智慧與電腦介面裝置(例如:滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等)互動時,發射。
當使用者將鼠標移到 GUI 元素時發生火災。
當使用者將鼠標移出 GUI 元素時發生火災。
在使用者移動滑鼠時,無論在哪個GUI元素內,都會發生火災。
當使用者滾動滑鼠輪時,滑鼠停在 GUI 元素上時,發生火災。
當使用者將滑鼠輪向前滾動時,發生火災,當滑鼠在 GUI 元素上時。
當使用遊戲控制器選擇器將 GuiObject 聚焦時,發射。
當遊戲控制器選擇器停止關注 GuiObject 時發射。
當玩家開始、繼續並停止長按 UI 元素時,發生火災。
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
當玩家在介面元素上移動手指時發生火災。
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
當玩家使用介面元素上的兩個手指執行撥動或拉動動作時,發生火焰。
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
當玩家使用介面元素上的兩個手指執行旋轉動作時,發生火災。
當玩家在介面元素上執行滑動動作時,發生火災。
當玩家在介面元素上執行點擊動作時,發生火焰。
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
當遊戲控制器選擇移動到、離開或變更連接的 GuiBase2d 或任何子控制器 GuiObjects 時發生火災。
屬性
AutoButtonColor
此屬性決定是否當使用者的 Mouse 將鼠標懸停或單擊時,按鈕會自動變更顏色。如果 true , 按鈕會在滑鼠停止在上面或單擊時自動變更顏色。如果 false , 按鈕不會變更。
如果您想自定义用戶的鼠標漂浮或單擊按鈕時按鈕的變化方式,考慮使用 ImageButton 並修改元素的 HoverImage 和 PressedImage 。
請注意,此屬性將不會對 ImageButton 有影響,如果其 Image 屬性設為圖像。此外,此屬性不會影響在其 不是 時的滑鼠漂浮,也不會影響滑鼠點擊時其 不是 。
方法
活動
Activated
當按鈕啟用時發生火災。由於此事件不會在伺服器上發生,因此只能在 LocalScript 或 Script 使用 RunContext 的 Enum.RunContext.Client 中使用。
參數
MouseButton1Click
當使用者的滑鼠完全點擊 GuiButton 時,此事件發生。
在點擊方面,滑鼠必須在 GuiButton 的範圍內,滑鼠按鈕必須壓下並再次向上壓下,才能在此事件發生前。如果滑鼠離開 GuiButton 的範圍並被釋放,事件將不會發觸發。如果您想避免這種限制,您可以使用 MouseButton1Down 和 MouseButton1Up;這些事件相似,但會在使用者按下左滑鼠按鈕向下或向上時發射,分別稱為「向下」和「向上」。
MouseButton1Down
當使用者按下左滑鼠按鈕時,此事件會在 GuiButton 上發生。
對於需要用戶按下 和 釋放左滑鼠在 GuiButton 以啟動事件的事件,請考慮使用 MouseButton1Click 。
參數
MouseButton1Up
當使用者釋放左滑鼠按鈕時,此事件會發生在 GuiButton 上。
對於需要用戶按下 和 釋放左滑鼠在 GuiButton 以啟動事件的事件,請考慮使用 MouseButton1Click 。
參數
MouseButton2Click
此事件發生時,使用者的滑鼠完全右鍵單擊 GuiButton 。
在點擊方面,滑鼠必須在 GuiButton 的範圍內,滑鼠按鈕必須壓下並再次向上壓下,才能在此事件發生前。如果滑鼠離開 GuiButton 的範圍並被釋放,事件將不會發觸發。如果您想避免這種限制,您可以使用 MouseButton2Down 和 MouseButton2Up;這些事件相似,但會在使用者按下右鍵或向上鍵時發射,分別依次。
MouseButton2Down
當使用者按下右滑鼠按鈕時,此事件會在 GuiButton 上發生。
對於需要用戶按下 和 釋放右鍵以在 GuiButton 發觸發事件的事件,請考慮使用 MouseButton2Click。
參數
MouseButton2Up
當使用者釋放右滑鼠按鈕時,此事件會發生在 GuiButton 上。
對於需要用戶按下 和 釋放右鍵以在 GuiButton 發觸發事件的事件,請考慮使用 MouseButton2Click。