GUIButton 是從 GuiObject 繼承的抽象類。它是 ImageButton 和 Class.TextButton
Class.GuiButton.Activated 是按鈕啟動時發生的 多平台事件 ,當按鈕啟動時發生時,按鈕將會釋按下。GuiButton.Activated時,這意
概要
屬性
決定是否在滑鼠悠閒時自動變更按鈕的顏色。
如果 GUI 元素可見,否則鼠標將不會鎖定,除非右鍵已按下。
一個Boolean 屬性,表示對象是否已選擇。
設定按鈕按鈕的造型,以基於預設造型的列表。
決定這個輸入是否會沉沒在此 UI 元素。
對 GuiObject 的起始點,相對於其絕對大小。
決定是否會在基於兒童內容的重新縮放。
決定 GuiObject 背景顏色。
決定 GuiObject 背景和邊框的透明度。
決定 GuiObject 邊框的顏色。
決定GuiObject邊框的大小與邊框相對位置。
決定 GuiObject 邊框的像素寬度。
決定是否在超級父元素 GUI 元素外會成像子元素 GuiObjects。
決定玩家的滑鼠是否正在按在 GuiObject 上或不是。
決定 GuiButton 是否可以與或不與互動,或是否要檢查 GuiState 的 GuiObject 是否正在變更或不變更。
使用 GuiObject 時,控制 UIGridStyleLayout 的排序順序。
設定 GuiObject 將在遊戲控制器選擇器向下移動時選擇。
設定 GuiObject ,當遊戲控制器選擇器移動到左邊時會選擇。
設置 GuiObject 將在遊戲控制器選擇器移動到右邊時選擇。
設定 GuiObject 將在遊戲控制器選手柄上移動時選擇。
決定 GuiObject 的像素和矢量位置。
確定 GuiObject 旋轉的程度。
確認遊戲控制器可以選擇 GUI 嗎。
覆蓋遊戲手柄的預設裝飾。
遊戲控制器選擇 GuiObjects 的程序順序。
決定 GuiObject 的像素和浮點大小。
Class.GuiObject.BackgroundTransparency|BackgroundTransparency 和 TextTransparency 的混合屬性。
決定是否要渲染 GuiObject 和它的子孫。
決定 GuiObject 與其他人相對的排名。
描述介面元素的實際屏幕位置,以幣晃。
描述 UI 元素的實際螢幕旋轉度。
描述 UI 元素的實際屏幕尺寸,以幣晃。
設為真的時,本地化將適用於此 GuiBase2d 和它的後代。
一個引用 LocalizationTable 以應用自動本地化到這個 GuiBase2d 和它的後代。
在下向方向中自訂遊戲控制器選擇行為。
在左向方向中自訂遊戲控制器選擇行為。
自訂遊戲控制器選擇行為。
在上方向中自訂遊戲控制器選擇行為。
允許自訂遊戲控制器選擇動作。
方法
方法 繼承自 GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
順滑地將一個 GUI 移至新的 UDim2 。
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
順滑地將 GUI 重新調整為新的 UDim2。
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
順滑地將一個 GUI 移動到新的尺寸和位置。
活動
按鈕啟用時會發生火焰。
發射時,鼠標完全離開時按一下 GUI 按鈕。
發射時,鼠標位於 GUI 對物件的左下狀態。
發射時,左鍵對象已釋放時,發射 GUI 對物件。
發射時,鼠標完全按下按鈕。
發射時,鼠標在 GUI 對物件上的右鍵狀態。
發射對象上的右鍵時。
發生時間發生時,使用者開始使用人機交互裝置 (滑鼠按鈕, 觸摸開始, 鍵盤按鈕等等)。
使用者改變人機交互裝置 (滑鼠按鈕、觸摸開始、鍵盤按鈕等) 時發生時間。
發生時間當使用者停止使用人類電腦介面裝置 (滑鼠按鈕關閉, 觸摸開始, 鍵盤按鈕下等) 時。
使用者移動滑鼠到 GUI 元素時會發生火焰。
發射一個使用者從 GUI 元素移動滑鼠時。
在使用者移動鼠標時,發射 GUI 元素內的任何時間。
發射時,使用者將鼠標輪向返回,當滑鼠位於一個 GUI 元素上。
發射時,使用者將鼠標輪向前移動,當滑鼠位於 GUI 元素上。
發射時 GuiObject 與遊戲控制器選擇器專注。
發射時Gamepad選擇器停止專注在GUI對象上。
玩家開始時、繼續和停止按長按 UI 元素。
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
玩家移動指針時發射。
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
發射時玩家使用兩個手指在 UI 元素上執行點擊或拉動動作時。
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
發生時玩家使用兩個手指在 UI 元素上執行旋轉動作時。
發射玩家在介面元素上執行擺動手勢時。
發射玩家在介面元素上執行點擊動作時。
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
發射在遊戲控制器選擇移動到,離開,或變更連接的 GuiBase2d 或任何子選項 GuiObjects。
屬性
AutoButtonColor
自動按鈕顏色將會在使用者的 Mouse 懸停或點擊時自動變更顏色。
如果是,按鈕會在滑鼠移動到或點擊時自動變更顏色。 如果是,按鈕不會變更。
如果您想自訂按鈕在用戶的滑鼠悠閒時或點擊時變更時的方式,請考慮使用 ImageButton GUI 並改變元素的 ImageButton.HoverImage 和 ImageButton.PressedImage。
請注意,此屬性對 ImageButton 沒有效果,如果它的屬性設為圖像,並且不是 null。此外,此屬性對於 4> Class.ImageButton.HoverImage4> 在鍵盤上按下時,它的 7> Class.ImageButton.PressedImage7>
範例程式碼
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = true
方法
活動
Activated
按鈕啟用時發射。這個事件不會在服務伺服器上發射,因此它只能在 LocalScript 或 Script 中使用,並且只有 RunContext 的 2>Class.Script.RunContext2> 使用。
參數
MouseButton1Click
MouseButton1Click 事件發生,當使用者的 Mouse 完全左鍵時按一下 GUI 按鈕。
通過點擊,鼠標必須位於按鈕的範圍內,並且必須再次按下和上升才能發生此事件。如果鼠標離開按鈕的範圍,並且被釋放,則事件將不會發觸發。如果您想避免此限制,您可以使用 GuiButton.MouseButton1Down 和 MouseButton
這個事件與 GuiButton.MouseButton2Click 相似,但與它們相同,因為它們連接到使用者的右鍵。
注意,此事件只有按鈕,包括 TextButtons 和 ImageButton 。它不會發射其他 GuiObjects 。
範例程式碼
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 。
參數
範例程式碼
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 。
參數
範例程式碼
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 。
範例程式碼
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 。
參數
範例程式碼
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 。
參數
範例程式碼
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)