GuiButton
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
GuiButton là một lớp thuộc tính tổng hợp thừa hưởng từ GuiObject. Nó là lớp cơ
Sự kiện quan trọng nhất của GuiButton là GuiButton.Activated, một sự kiện 多-platform khi nút được kích hoạt. Khi sử dụ
Tóm Tắt
Thuộc Tính
Xác định màu sắc của nút khi chuột hoạt động trên hoặc nhấp vào nó.
Nếu đúng khi thành phần GUI đang hiển thị, chuột sẽ không bị khóa nếu nút chuột phải không được nhấn.
Một đặt tínhBoolean để cho biết có phải chọn một đối tượng nào không.
Định dạng kiểu của GuiButton dựa trên một danh sách các kiểu đã định.
Xác định whether this UI element sinks input.
Xác định điểm nguồn của một GuiObject , so với kích thước tương đối của nó.
Xác định xem resize có xảy ra dựa trên nội dung con hay không.
Xác định màu nền GuiObject .
Xác định độ trong suốt của GuiObject hình ảnh và biên giới.
Xác định màu của GuiObject border.
Xác định cách mà GuiObject biên giới được phân bố đối với kích thước của nó.
Xác định chiều rộng pixel của GuiObject biên giới.
Xác định nếu con cháu GuiObjects nằm ngoài giới hạn của một thành phần GUI cha mẹ nên tạo ra.
Xác định apakah chuột của người chơi đang được nhấn chủ động trên GuiObject hay không.
Xác định có thể hay không tương tác với GuiButton , hoặc liệu GuiState của GuiObject đang thay đổi hay không.
Điều khiển thứ tự sắp xếp của GuiObject khi được sử dụng với một UIGridStyleLayout .
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển xuống.
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển sang bên trái.
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển sang phải.
Điều chỉnh GuiObject được chọn khi gamepad selector di chuyển lên trên.
Xác định vị trí pixel và vị trí trục của GuiObject .
Xác định số độ bằng mà GuiObject được quay.
Xác định có thể chọn GUI bằng gamepad.
Làm cho trang trí chọn mặc định của gamepad bị tắt.
Thứ tự của GuiObjects được chọn bởi gamepad UI lựa chọn.
Xác định kích thước pixel và kích thước trục của GuiObject .
Điều chỉnh các trục Size mà GuiObject sẽ dựa trên, so với kích thước của cha mình.
Một tính chất hỗn hợp của BackgroundTransparency và TextTransparency .
Xác định có phải GuiObject và con cháu của nó sẽ được xử lý.
Xác định thứ tự mà một GuiObject tạo gần những người khác.
Mô tả vị trí màn hình thực tế của một thành phần UI, bằng cách đếm các pixel.
Mô tả sự quay màn hình thực tế của một thành phần UI, bằng độ.
Mô tả kích thước màn hình thực tế của một thành phần UI, bằng các pixel.
Khi đặt về true, localization sẽ được áp dụng cho GuiBase2d và những con cháu của nó.
Một tham khảo đến một LocalizationTable để ứng dụng hóa học hóa toàn bộ vào GuiBase2d và các con cháu của nó.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng dưới.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng bên trái.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng phải.
Tùy chỉnh hành vi lựa chọn gamepad trong hướng lên.
Cho phép tùy chỉnh chuyển động của nút gamepad.
Phương Pháp
Phương Pháp kế thừa từ GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Di chuyển một GUI mượt mà đến một new UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Điều chỉnh mượt mà một GUI lên một new Datatype.UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Di chuyển một GUI một cách mượt mà đến kích thước và vị trí mới.
Sự Kiện
Bắt lửa khi nút được kích hoạt.
Đã khởi động khi chuột hoàn toàn rời khỏi nhấp vào nút GUI.
Bắt đầu khi chuột ở trạng thái bên dưới của chuột trên đối tượng GUI.
Bắt đầu khi chuột trái đã thả vật GUI.
Đã khởi động khi chuột hoàn toàn nhấp vào nút GUI.
Bắt đầu khi chuột ở trạng thái đúng chuột dưới cùng trên đối tượng GUI.
Bắt đầu khi nút chuột phải đã được thả trên một đối tượng GUI.
Được kích hoạt khi một người bắt đầu tương tác thông qua một thiết bị giao tiếp người-máy (chuột bên dưới, chạm bắt đầu, nút bàn phím xuống, v.v.v).
Bị kích động khi một người thay đổi cách họ tương tác thông qua thiết bị giao tiếp Người-Máy (chuột, bắt đầu, nhấn bàn phím, v.v..).
Đã kết thúc khi một người dừng tương tác thông qua thiết bị Giao tiếp Người-Máy (chuột bên dưới, chạm bắt đầu, nút bàn phím xuống, v.v.);.
Bắt đầu khi người dùng di chuyển chuột vào một thành phần GUI.
Bắt đầu khi người dùng di chuyển chuột khỏi một thành phần GUI.
Bắt lửa mỗi khi một người dịch chuột trong khi nó ở trong một thành phần GUI.
Bắt đầu khi người dùng cuộn chuột chuột của họ trở lại khi chuột đang ở trên một thành phần GUI.
Bắt đầu khi người dùng di chuyển bánh xe chuột của họ khi chuột ở trên một thành phần GUI.
Được kích hoạt khi GuiObject đang được tập trung với GamepadSelector.
Bị kích hoạt khi GamepadSelector ngưng tập trung vào GuiObject.
Lửa khi người chơi bắt đầu, tiếp tục và dừng lại sau khi nhấn mạnh UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Bắt đầu khi người chơi di chuyển ngón tay của họ trên thành phần UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Bắt lửa khi người chơi thực hiện một hành động nhấn hoặc kéo dùng hai ngón tay trên thành phần UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Bắt đầu khi người chơi thực hiện một hành động quay bằng hai ngón tay trên thành phần UI.
Bắt đầu khi người chơi thực hiện một động tác trượt tuyết trên một thành phần UI.
Bắt đầu khi người chơi thực hiện một hành động nhấn chuột trên thành phần UI.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Kích hoạt khi lựa chọn gamepad di chuyển đến, rời đi hoặc thay đổi trong khu vực GuiBase2d hoặc bất kỳ con cháu GuiObjects kế tiếp.
Thuộc Tính
AutoButtonColor
AutoButtonColor xác định màu sắc của nút nếu nút đó bị giữ Mouse hoặc nhấp vào nó khi người dùng giữ hoặc nhấp vào nút.
Nếu đúng, nút sẽ tự động thay đổi màu khi chuột hoạt động trên hoặc nhấp vào nó. Nếu sai, nút sẽ không thay đổi.
Nếu bạn muốn tùy chỉnh cách mà nút thay đổi khi chuột người dùng hoover over hoặc nhấp vào nó, hãy xem xét sử dụng một ImageButton GUI và thay đổi thuộc tính của thành phần ImageButton.HoverImage và ImageButton.PressedImage .
Lưu ý rằng thuộc tính này sẽ không có hiệu lực trên một ImageButton nếu nó được đặt trên một hình ảnh và không phải là nul. Ngoài ra, thuộc tính này sẽ k
Mẫu mã
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = true
Modal
Nếu đúng khi thành phần GUI đang hiển thị, chuột sẽ không bị khóa nếu nút chuột phải không được nhấn.
Phương Pháp
Sự Kiện
Activated
Kích hoạt khi nút được kích hoạt. Vì sự kiện này không kích hoạt trên máy chủ, nó chỉ nên được sử dụng trong một LocalScript , hoặc trong một Script với RunContext của 2>Enum.RunContext.Client
Tham Số
MouseButton1Click
Sự kiện MouseButton1Click bắt đầu khi người dùng Mouse hoàn toàn bỏ lại những lần nhấp chuột trên GUI.
Bằng cách nhấp chuột, chuột phải ở trong giới hạn của nút và phải được nhấn lại trước khi sự kiện này bắt đầu. Nếu chuột rời khỏi giới hạn của nút và được thả, sự kiệ
Sự kiện này tương tự như GuiButton.MouseButton2Click, which behaves identically except that it is connected to the user's right mouse button.
Lưu ý rằng sự kiện này chỉ bắt lửa cho các nút GUI, bao gồm TextButtons và ImageButton . Nó sẽ không bắt lửa cho các GuiObjects khác.
Mẫu mã
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
Sự kiện MouseButton1Down xảy ra khi người dùng nhấn vào nút Mouse bên dưới trên mục GUI.
Sự kiện này tương tự như GuiButton.MouseButton2Down, which behaves identically except that it is connected to the user's right mouse button.
Nếu bạn đang tìm kiếm một sự kiện yêu cầu người dùng phải nhấn và thả chuột trái của họ trên một GUI để cho phép sự kiện bắt đầu, hãy xem xét sử dụng GuiButton.MouseButton1Click.
Lưu ý rằng sự kiện này chỉ bắt lửa cho các nút GUI, bao gồm TextButtons và ImageButton . Nó sẽ không bắt lửa cho các GuiObjects khác.
Tham Số
Phối hợp x screen coordinate của chuột trong pixel.
Phối hợp vị trí màn hình chuột trong pixel.
Mẫu mã
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
Sự kiện MouseButton1Up xảy ra khi người dùng thả bên trái của họ Mouse ra khỏi mục đích GUI.
Sự kiện này tương tự như GuiButton.MouseButton2Up, which behaves identically except that it is connected to the user's right mouse button.
Nếu bạn đang tìm kiếm một sự kiện yêu cầu người dùng phải nhấn và thả chuột trái của họ trên một GUI để cho phép sự kiện bắt đầu, hãy xem xét sử dụng GuiButton.MouseButton1Click.
Lưu ý rằng sự kiện này chỉ bắt lửa cho các nút GUI, bao gồm TextButtons và ImageButton . Nó sẽ không bắt lửa cho các GuiObjects khác.
Tham Số
Phối hợp x screen coordinate của chuột trong pixel.
Phối hợp vị trí màn hình chuột trong pixel.
Mẫu mã
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
Sự kiện MouseButton2Click bắt đầu khi người dùng hoàn toàn nhấp chuột vào nút GUI.
Bằng cách nhấp chuột, chuột phải ở trong giới hạn của nút và phải được nhấn lại trước khi sự kiện này bắt đầu. Nếu chuột rời khỏi giới hạn của nút và được thả, sự kiệ
Sự kiện này giống như GuiButton.MouseButton1Click, which behaves identically except that it is connected to the user's left mouse button.
Lưu ý rằng sự kiện này chỉ bắt lửa cho các nút GUI, bao gồm TextButtons và ImageButton . Nó sẽ không bắt lửa cho các GuiObjects khác.
Mẫu mã
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
Sự kiện MouseButton2Down bắt đầu khi người dùng nhấn vào nút right Mouse trên mục GUI.
Sự kiện này giống như GuiButton.MouseButton1Down, which behaves identically except that it is connected to the user's left mouse button.
Nếu bạn đang tìm kiếm một sự kiện yêu cầu người dùng nhấn và thả chuột phải của họ trên một GUI để cho phép sự kiện bắt đầu, hãy xem xét sử dụng GuiButton.MouseButton2Click .
Lưu ý rằng sự kiện này chỉ bắt lửa cho các nút GUI, bao gồm TextButtons và ImageButton . Nó sẽ không bắt lửa cho các GuiObjects khác.
Tham Số
Phối hợp x screen coordinate của chuột trong pixel.
Phối hợp vị trí màn hình chuột trong pixel.
Mẫu mã
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
Sự kiện MouseButton2Up bắt đầu khi người dùng thả nút phải của họ ra khỏi mục GUI.
Sự kiện này tương tự như GuiButton.MouseButton1Up, which behaves identically except that it is connected to the user's left mouse button.
Nếu bạn đang tìm kiếm một sự kiện yêu cầu người dùng nhấn và thả chuột phải của họ trên một GUI để cho phép sự kiện bắt đầu, hãy xem xét sử dụng GuiButton.MouseButton2Click .
Lưu ý rằng sự kiện này chỉ bắt lửa cho các nút GUI, bao gồm TextButtons và ImageButton . Nó sẽ không bắt lửa cho các GuiObjects khác.
Tham Số
Phối hợp x screen coordinate của chuột trong pixel.
Phối hợp vị trí màn hình chuột trong pixel.
Mẫu mã
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)