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 trừu tượng thừa kế từ GuiObject .Nó là lớp cơ sở cho các đối tượng tương tác, có thể nhấp vào ImageButton và TextButton .Lớp này cũng định nghĩa một số thuộc tính cho hành vi tương tác, đó là AutoButtonColor và Modal .
Sự kiện quan trọng nhất của một GuiButton là Activated , một sự kiện nhiều nền tảng bắt lửa khi nút được kích hoạt.Khi sử dụng chuột, điều này có nghĩa là nhấp vào nút và thả với con trỏ vẫn ở trên đối tượng UI.Đối với cảm ứng, cùng áp dụng nhưng với một cú chạm thay vì nhấn nút.Cuối cùng, đối với gamepad, Activated bắt lửa nếu một GuiButton được chọn khi nút A được nhấn và thả.Tóm lại, sự kiện này rất hữu ích cho lập trình giao diện người dùng nhiều nền tảng vì nó cung cấp một giao diện đẹp chung cho một lượt nhập của một người dùng.
Tóm Tắt
Thuộc Tính
Xác định xem liệu nút có thay đổi màu tự động khi chuột di chuyển qua hoặc nhấp vào nó hay không.
Một ví dụ HapticEffect sẽ chơi khi GuiButton đang được di chuột.
Nếu true trong khi thành phần GUI hiển thị, chuột sẽ không bị khóa trừ khi nút chuột phải đang ở dưới.
Một ví dụ HapticEffect sẽ chơi khi GuiButton được nhấn.
Một thuộc tính boolean cho thấy liệu đối tượng đã được chọn hay chưa.
Đặt phong cách của GuiButton dựa trên một danh sách các phong cách đã định trước.
Xác định xem yếu tố UI này có chìm nhập hay không.
Xác định điểm nguồn của một GuiObject , so với kích thước tuyệt đối của nó.
Xác định xem có thay đổi kích thước xảy ra dựa trên nội dung con không.
Xác định màu nền GuiObject .
Xác định độ trong suốt của nền và biên giới GuiObject .
Xác định màu của biên giới GuiObject .
Xác định theo cách nào biên giới GuiObject được xếp theo kích thước của nó.
Xác định chiều rộng pixel của biên giới GuiObject .
Xác định xem con cháu GuiObjects bên ngoài giới hạn của một yếu tố GUI cha có nên hiển thị hay không.
Xác định xem chuột của người chơi đang được nhấn chủ động trên GuiObject hay không.
Xác định liệu GuiButton có thể tương tác với nó hay không, hoặc nếu GuiState của GuiObject đang thay đổi hay không.
Kiểm soát thứ tự sắp xếp của GuiObject khi sử dụng với UIGridStyleLayout .
Bộ GuiObject được chọn khi công tắc gamepad được di chuyển xuống dưới.
Bộ GuiObject được chọn khi chọn gamepad bị di chuyển sang bên trái.
Bộ GuiObject được chọn khi chọn gamepad bị di chuyển sang bên phải.
Bộ GuiObject được chọn khi công tắc gamepad được di chuyển lên trên.
Xác định vị trí pixel và vectơ của GuiObject .
Xác định số độ mà GuiObject được xoay.
Xác định xem liệu GuiObject có thể được chọn bởi gamepad hay không.
Thay thế trang trí lựa chọn mặc định được sử dụng cho gamepad.
Thứ tự của GuiObjects được chọn bởi lựa chọn UI gamepad.
Xác định kích thước pixel và phương trình của GuiObject .
Đặt các trục Size mà GuiObject sẽ dựa trên, so với kích thước của cha của nó.
Một tính chất hỗn hợp của BackgroundTransparency và TextTransparency .
Xác định xem GuiObject và con cháu của nó sẽ được hiển thị hay không.
Xác định thứ tự mà một GuiObject render so với những người khác.
Mô tả vị trí màn hình thực của một thành phần GuiBase2d , trong điểm ảnh.
Mô tả sự xoay màn hình thực sự của một thành phần GuiBase2d , trong độ.
Mô tả kích thước màn hình thực của một thành phần GuiBase2d , bằng像素.
Khi được đặt thành true , bản địa hóa sẽ được áp dụng cho GuiBase2d và con cháu của nó.
Một tham chiếu đến một LocalizationTable để được sử dụng để áp dụng lok hóa tự động cho GuiBase2d và con cháu của nó.
Tùy chỉnh hành vi lựa chọn gamepad theo chiều xuống.
Tùy chỉnh hành vi lựa chọn gamepad theo hướng bên trái.
Tùy chỉnh hành vi lựa chọn gamepad theo hướng bên 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 lựa chọn 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 : boolean,callback : function):boolean
Di chuyển một GUI mượt mà sang một mới 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
Di chuyển một GUI mượt mà sang một kích cỡ và vị trí mới.
Sự Kiện
Bắt lửa khi nút được kích hoạt.
Bắt lửa khi chuột của người dùng hoàn toàn nhấp vào GuiButton .
Bắt lửa khi người dùng nhấn nút chuột trái của họ xuống trên GuiButton .
Bắt lửa khi người dùng thả nút chuột trái của họ khỏi GuiButton .
Bắt lửa khi chuột của người dùng hoàn toàn nhấp chuột phải vào GuiButton .
Bắt lửa khi người dùng nhấn nút chuột phải của họ xuống trên GuiButton .
Bắt lửa khi người dùng thả nút chuột phải của họ khỏi GuiButton .
Bị sa thải khi người dùng bắt đầu tương tác thông qua thiết bị Giao diện Con người - Máy tính ( nút chuột xuống, chạm bắt đầu, nút bàn phím xuống, v.v.).
Bị sa thải khi người dùng thay đổi cách họ tương tác thông qua thiết bị Giao diện Con người - Máy tính ( nút chuột xuống, chạm bắt đầu, nút bàn phím xuống, v.v.).
Bị sa thả khi người dùng ngừng tương tác thông qua thiết bị Giao diện Con người - Máy tính ( nút chuột xuống, chạm bắt đầu, nút bàn phím xuống, v.v.).
Bắt lửa khi người dùng di chuyển con trỏ vào một thành phần GUI.
Bắt lửa khi người dùng di chuyển con trỏ ra khỏi một thành phần GUI.
Bắt lửa mỗi khi người dùng di chuyển con trỏ trong khi nó nằm bên trong thành phần GUI.
Bắt lửa khi người dùng cuộn bánh xe chuột trở lại khi chuột ở trên một thành phần GUI.
Bắt lửa khi một người dùng cuộn bánh xoay chuột của họ về phía trước khi chuột ở trên một thành phần GUI.
Bị sa thả khi GuiObject được tập trung vào với lựa chọn Gamepad.
Bị sa thả khi lựa chọn Gamepad ngừng tập trung vào GuiObject.
Bắt lửa khi người chơi bắt đầu, tiếp tục và dừng việc giữ lâu UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Bắt lửa khi người chơi di chuyển ngón tay 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 cử chỉ kéo hoặc kéo bằ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 lửa khi người chơi thực hiện cử chỉ xoay bằng hai ngón tay trên thành phần UI.
Bắt lửa khi người chơi thực hiện cử chỉ vuốt trên thành phần UI.
Bắt lửa khi người chơi thực hiện một cử chỉ vuốt trên thành phần UI.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Bắt lửa khi lựa chọn gamepad di chuyển đến, rời hoặc thay đổi trong khu vực kết nối GuiBase2d hoặc bất kỳ con trai nào GuiObjects .
Thuộc Tính
AutoButtonColor
Tính chất này xác định xem liệu nút có thay đổi màu tự động khi người dùng đang lướt qua hoặc nhấp vào nó hay không Mouse.Nếu true , nút sẽ tự động thay đổi màu khi chuột di chuyển qua hoặc nhấp vào nó.Nếu false , nút sẽ không thay đổi.
Nếu bạn muốn tùy chỉnh cách một nút thay đổi khi chuột của người dùng lướt qua hoặc nhấp vào nó, hãy xem xét sử dụng ImageButton và thay đổi HoverImage và PressedImage của thành phần.
Xin lưu ý rằng thuộc tính này sẽ không có ảnh hưởng đến một ImageButton nếu thuộc tính Image của nó được đặt thành hình ảnh.Ngoài ra, thuộc tính này sẽ không ảnh hưởng đến một ImageButton khi chuột di chuyển khi địa chỉ HoverImage của nó không phải là nil , hoặc không khi chuột nhấp vào nếu địa chỉ PressedImage của nó không phải là nil .
Modal
Nếu true trong khi thành phần GUI hiển thị, chuột sẽ không bị khóa trừ khi nút chuột phải đang ở dưới.
Phương Pháp
Sự Kiện
Activated
Bắt lửa khi nút được kích hoạt.Vì sự kiện này không bắt lửa 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 Enum.RunContext.Client .
Tham Số
MouseButton1Click
Sự kiện này bắt lửa khi chuột của người dùng hoàn toàn nhấp vào GuiButton .
Về việc nhấp chuột, chuột phải phải nằm trong giới hạn của GuiButton và nút chuột phải phải được nhấn xuống và lên một lần nữa trước khi sự kiện này bắt lửa.Nếu chuột rời khỏi giới hạn của GuiButton và được phát hành, sự kiện sẽ không bắt lửa.Nếu bạn muốn tránh giới hạn này, bạn có thể sử dụng MouseButton1Down và MouseButton1Up ; những sự kiện này tương tự nhưng sẽ bắt lửa bất cứ khi nào người dùng nhấn nút chuột trái hoặc trên cùng, lần lượt.
MouseButton1Down
Sự kiện này bắt lửa khi người dùng nhấn nút chuột trái của họ xuống trên GuiButton .
Đối với một sự kiện yêu cầu người dùng nhấn và phát hành chuột trái của họ trên GuiButton để sự kiện bắt lửa, hãy xem xét sử dụng MouseButton1Click .
Tham Số
Vị trí trên màn hình của chuột X bằng pixel.
Vị trí trên màn hình của chuột Y bằng pixel.
MouseButton1Up
Sự kiện này bắt lửa khi người dùng thả nút chuột trái của họ khỏi GuiButton .
Đối với một sự kiện yêu cầu người dùng nhấn và phát hành chuột trái của họ trên GuiButton để sự kiện bắt lửa, hãy xem xét sử dụng MouseButton1Click .
Tham Số
Vị trí trên màn hình của chuột X bằng pixel.
Vị trí trên màn hình của chuột Y bằng pixel.
MouseButton2Click
Sự kiện này bắt lửa khi chuột của người dùng hoàn toàn nhấp chuột phải vào GuiButton .
Về việc nhấp chuột, chuột phải phải nằm trong giới hạn của GuiButton và nút chuột phải phải được nhấn xuống và lên một lần nữa trước khi sự kiện này bắt lửa.Nếu chuột rời khỏi giới hạn của GuiButton và được phát hành, sự kiện sẽ không bắt lửa.Nếu bạn muốn tránh giới hạn này, bạn có thể sử dụng MouseButton2Down và MouseButton2Up ; những sự kiện này tương tự nhưng sẽ bắt lửa bất cứ khi nào người dùng nhấn nút chuột phải hoặc trên cùng, tương ứng.
MouseButton2Down
Sự kiện này bắt lửa khi người dùng nhấn nút chuột phải của họ xuống trên GuiButton .
Đối với một sự kiện yêu cầu người dùng nhấn và phát hành chuột phải của họ trên GuiButton để sự kiện bắt lửa, hãy xem xét sử dụng MouseButton2Click .
Tham Số
Vị trí trên màn hình của chuột X bằng pixel.
Vị trí trên màn hình của chuột Y bằng pixel.
MouseButton2Up
Sự kiện này bắt lửa khi người dùng thả nút chuột phải của họ khỏi GuiButton .
Đối với một sự kiện yêu cầu người dùng nhấn và phát hành chuột phải của họ trên GuiButton để sự kiện bắt lửa, hãy xem xét sử dụng MouseButton2Click .
Tham Số
Vị trí trên màn hình của chuột X bằng pixel.
Vị trí trên màn hình của chuột Y bằng pixel.