GuiButton

Hiển Thị Bản Đã Lỗi Thời

*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.

Không Thể Tạo
Không Thể Duyệt

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 ImageButtonTextButton .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à AutoButtonColorModal .

Sự kiện quan trọng nhất của một GuiButtonActivated , 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

Thuộc Tính kế thừa từ GuiObjectThuộc Tính kế thừa từ GuiBase2d

Phương Pháp

Phương Pháp kế thừa từ GuiObject

Sự Kiện

Sự Kiện kế thừa từ GuiObjectSự Kiện kế thừa từ GuiBase2d

Thuộc Tính

AutoButtonColor

Đọc Song Song

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 HoverImagePressedImage 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 .

HoverHapticEffect

Đọc Song Song

Một ví dụ HapticEffect sẽ chơi khi GuiButton đang được di chuột.

Đọc Song Song

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.

PressHapticEffect

Đọc Song Song

Một ví dụ HapticEffect sẽ chơi khi GuiButton được nhấn.

Selected

Đọc Song Song

Một thuộc tính boolean cho thấy liệu đối tượng đã được chọn hay chưa.

Đọc Song Song

Đặt phong cách của GuiButton dựa trên một danh sách các phong cách đã định trước.

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ố

inputObject: InputObject
clickCount: number

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 MouseButton1DownMouseButton1Up ; 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 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 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 MouseButton2DownMouseButton2Up ; 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 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 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.