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

  • AutoButtonColor:bool
    Đọc Song Song

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

  • Modal:bool
    Đọc Song Song

    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.

  • Selected:bool
    Đọc Song Song

    Một đặt tínhBoolean để cho biết có phải chọn một đối tượng nào không.

  • Style:Enum.ButtonStyle
    Đọc Song Song

    Định dạng kiểu của GuiButton dựa trên một danh sách các kiểu đã định.

Thuộc Tính kế thừa từ GuiObjectThuộc Tính kế thừa từ GuiBase2d
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

Phương Pháp kế thừa từ GuiObject
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Sự Kiện

Sự Kiện kế thừa từ GuiObjectSự Kiện kế thừa từ GuiBase2d
  • 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.

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Thuộc Tính

AutoButtonColor

bool
Đọc Song Song

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ã

The code below enables a button's GuiButton.AutoButtonColor as long as it it not a ImageButton with ImageButton.HoverImage and ImageButton.PressedImage properties set to images.

In order for the code to work as expected, it must be placed in a LocalScript that is a child of the button.

Changing a GUI Button's Color on Hover and Click
local button = script.Parent



if button:IsA("ImageButton") then

	if button.HoverImage and button.ClickImage then

		return

	end

end



button.AutoButtonColor = true
bool
Đọc Song Song

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.

Selected

bool
Đọc Song Song

Một đặt tínhBoolean để cho biết có phải chọn một đối tượng nào không.

Style

Enum.ButtonStyle
Đọc Song Song

Định dạng kiểu của GuiButton dựa trên một danh sách các kiểu đã định.

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

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ố

inputObject: InputObject
clickCount: number

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ã

The code sample below demonstrates how to use the GuiButton.MouseButton1Click and GuiButton.MouseButton2Click events to handle user left and right mouse button input on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling User Clicks on a GUI Button
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ố

x: number

Phối hợp x screen coordinate của chuột trong pixel.

y: number

Phối hợp vị trí màn hình chuột trong pixel.


Mẫu mã

The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Right Mouse Button Up/Down on a GUI Button
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ố

x: number

Phối hợp x screen coordinate của chuột trong pixel.

y: number

Phối hợp vị trí màn hình chuột trong pixel.


Mẫu mã

The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Right Mouse Button Up/Down on a GUI Button
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ã

Demonstrates how to use the GuiButton.MouseButton2Click event to detect when a user right clicks a GuiButton.

The mouse has to be in bounds of the button and has to be pressed down and up again before this event fires.

Note: place the "RightClickScreenGui" within StarterGui for this sample to work properly.

GUI Button Right Click
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ố

x: number

Phối hợp x screen coordinate của chuột trong pixel.

y: number

Phối hợp vị trí màn hình chuột trong pixel.


Mẫu mã

The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Left Mouse Button Up/Down on a GUI Button
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ố

x: number

Phối hợp x screen coordinate của chuột trong pixel.

y: number

Phối hợp vị trí màn hình chuột trong pixel.


Mẫu mã

The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.

For the example to work expected, the LocalScript containing the code should be a child of the GUI button.

Handling Left Mouse Button Up/Down on a GUI Button
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)
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object