GuiButton 는 GuiObject 에서 상속된 추상 클래스입니다.상호 작용 가능한 클릭 가능한 ImageButton 및 TextButton 개체의 기본 클래스입니다.이 클래스는 또한 상호 작용 행동을 위한 여러 속성을 정의하며, 즉 AutoButtonColor 및 Modal입니다.
가장 중요한 이벤트는 버튼이 활성화될 때 발생하는 다중 플랫폼 이벤트입니다.마우스를 사용할 때 이는 버튼을 클릭하고 UI 개체에 커서가 여전히 있는 상태에서 릴리스하는 것을 의미합니다.터치의 경우 동일하게 적용되지만 버튼 누르다대신 터치가 사용됩니다.마지막으로, 게임패드의 경우, 버튼이 누르고 릴리스되었을 때 선택된 가 발생합니다.간단히 말해, 이 이벤트는 단일 사용자 입력에 대한 좋은 일반 인터페이스를 제공하므로 다중 플랫폼 사용자 인터페이스 프로그래밍에 매우 유용합니다.
요약
속성
마우스가 버튼 위로 이동하거나 클릭하면 버튼의 색이 자동으로 변경되는지 여부를 결정합니다.
HapticEffect 가 재생될 때 플레이할 GuiButton 인스턴스.
GUI 요소가 표시되는 동안 true 이면 오른쪽 마우스 버튼이 아래로 내려가지 않으면 마우스가 잠겨지지 않습니다.
A HapticEffect 인스턴스가 누르면 재생될 GuiButton 인스턴스.
개체가 선택되었는지를 나타내는 부울 속성입니다.
미리 결정된 스타일 목록에 따라 GuiButton의 스타일을 설정합니다.
이 UI 요소가 입력을 받아들이는지 여부를 결정합니다.
상대적인 크기에 따라 GuiObject 의 원점을 결정하고 절대 크기에 따라 결정합니다.
자식 콘텐츠에 따라 크기 조정이 발생하는지 여부를 결정합니다.
배경색 GuiObject을 결정합니다.
배경과 경계의 투명도를 GuiObject 결정합니다.
GuiObject 경계의 색상을 결정합니다.
GuiObject 경계가 해당 차원에 대해 어떻게 배치되는지 결정합니다.
GuiObject 경계의 픽셀 너비를 결정합니다.
부모 GUI 요소의 범위 외부에서 후손 요소 GuiObjects 가 렌더링되어야 하는지 여부를 결정합니다.
플레이어의 마우스가 GuiObject 활성적으로 누르고 있는지 여부를 결정합니다.
GuiButton 와 상호작용할 수 있는지 또는 GuiState 의 GuiObject 가 변경되는지 여부를 결정합니다.
GuiObject를 사용하여 정렬 순서를 제어하며 UIGridStyleLayout와 함께 사용됩니다.
게임패드 선택기가 아래로 이동되면 선택될 GuiObject 를 설정합니다.
게임패드 선택기가 왼쪽으로 이동되면 선택될 GuiObject 를 설정합니다.
게임패드 선택기가 오른쪽으로 이동되면 선택될 GuiObject 를 설정합니다.
게임패드 선택기가 위쪽으로 이동되면 선택될 GuiObject 를 설정합니다.
GuiObject의 픽셀 및 스칼라 위치를 결정합니다.
GuiObject가 회전된 정도의 수를 결정합니다.
게임패드에서 선택할 수 있는 GuiObject 여부를 결정합니다.
게임패드에 사용되는 기본 선택 장식을 재정의합니다.
게임패드 UI 선택에 의해 선택된 GuiObjects의 순서.
GuiObject의 픽셀 및 스칼라 크기를 결정합니다.
BackgroundTransparency 와 TextTransparency 의 혼합 속성.
GuiObject 및 그 하위 요소가 렌더링될지 여부를 결정합니다.
다른 사람들에 비해 GuiObject가 렌더링되는 순서를 결정합니다.
픽셀로 표시되는 실제 화면 위치의 GuiBase2d 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소
GuiBase2d 요소의 실제 화면 회전을 도 단위로 설명합니다.
픽셀로 표시되는 실제 화면 크기의 GuiBase2d 요소를 설명합니다.
true 로 설정되면 지역화가 이 GuiBase2d 및 그 하위에 적용됩니다.
이 GuiBase2d 및 그 하위에 자동화된 로캘리제이션을 적용하기 위해 사용할 LocalizationTable 참조.
아래쪽 방향으로 게임패드 선택 행동을 사용자 지정합니다.
왼쪽 방향에서 게임패드 선택 동작을 사용자 지정합니다.
오른쪽 방향으로 게임패드 선택 행동을 사용자 지정합니다.
위쪽으로 게임패드 선택 행동을 사용자 지정합니다.
게임패드 선택 이동을 사용자 지정할 수 있습니다.
메서드
메서드가 GuiObject에서 상속되었습니다- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
매끄럽게 GUI를 새로운 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
GUI를 새 크기와 위치로 부드럽게 이동합니다.
이벤트
버튼이 활성화되면 발생합니다.
사용자의 마우스가 완전히 클릭하면 GuiButton에 불이 붙습니다.
사용자가 GuiButton 에서 왼쪽 마우스 버튼을 누르면 발생합니다.
사용자가 왼쪽 마우스 버튼을 해제할 때 발생합니다 GuiButton .
사용자의 마우스가 완전히 오른쪽 클릭하여 GuiButton에 불을 붙이면 발생합니다.
사용자가 GuiButton 에서 오른쪽 마우스 버튼을 누르면 발생합니다.
사용자가 오른쪽 마우스 버튼을 릴리스할 때 발생합니다 GuiButton .
사용자가 인간-컴퓨터 인터페이스 장치(마우스 버튼 아래로, 터치 시작, 키보드 버튼 아래로 등)를 통해 상호 작용을 시작할 때 발생합니다.
사용자가 인간-컴퓨터 인터페이스 장치(마우스 버튼 아래로, 터치 시작, 키보드 버튼 아래로 등)를 통해 상호 작용하는 방식을 변경할 때 발생합니다.
사용자가 인간-컴퓨터 인터페이스 장치(마우스 버튼 아래로, 터치 시작, 키보드 버튼 아래로 등)를 통해 상호 작용을 중지할 때 발생합니다.
사용자가 GUI 요소로 마우스를 이동할 때 발생합니다.
사용자가 GUI 요소에서 마우스를 이동할 때 발생합니다.
사용자가 GUI 요소 내에서 마우스를 이동할 때마다 발생합니다.
사용자가 GUI 요소 위에 마우스를 스크롤할 때 마우스 휠을 뒤로 스크롤하면 발생합니다.
사용자가 GUI 요소 위에 마우스를 스크롤할 때 마우스 휠을 앞으로 스크롤하면 발생합니다.
게임패드 선택기로 GuiObject가 포커스되는 경우 발생합니다.
게임패드 선택기가 GuiObject에 대한 초점을 멈추면 발생합니다.
플레이어가 UI 요소를 길게 누르기 시작하면 발생하고, 계속되고, 중지됩니다.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
플레이어가 UI 요소에 손가락을 이동할 때 발생합니다.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
UI 요소에서 두 손가락을 사용하여 핀치 또는 당기기 제스처를 수행할 때 발생합니다.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
UI 요소에서 두 손가락을 사용하여 회전 제스처를 수행할 때 발생합니다.
플레이어가 UI 요소에 스와이프 제스처를 수행할 때 발생합니다.
플레이어가 UI 요소에 탭 제스처를 수행할 때 발생합니다.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
연결된 게임패드 선택이 이동하거나, 나가거나, 변경되면 발생합니다. GuiBase2d 또는 모든 하위 요소에서 GuiObjects 입니다.
속성
AutoButtonColor
이 속성은 사용자의 Mouse나 클릭으로 버튼의 색이 자동으로 변경되는지 여부를 결정합니다.If true , 버튼은 마우스가 이동하거나 클릭할 때 색상이 자동으로 변경됩니다.만약 false , 버튼은 변경되지 않습니다.
사용자의 마우스가 호버하거나 클릭하면 버튼이 어떻게 변경되는지 사용자 지정하려는 경우 ImageButton를 사용하고 요소의 HoverImage와 PressedImage을 변경하는 것을 고려하십시오.
이 속성이 이미지로 설정된 경우 속성에 영향을 주지 않는다는 점에 유의하십시오.또한, 이 속성은 그 가 아닐 때 마우스 호버에서 에 영향을 주지 않으며, 그 가 아닐 때 마우스 클릭에서도 영향을 주지 않습니다.
메서드
이벤트
Activated
버튼이 활성화되면 발생합니다.이 이벤트는 서버에서 발생하지 않으므로, 단지 에서 또는 에서 의 의 의 의 용으로만 사용해야 합니다.
매개 변수
MouseButton1Click
이 이벤트는 사용자의 마우스가 완전히 클릭하여 GuiButton 를 클릭할 때 발생합니다.
클릭과 관련하여, 마우스는 GuiButton의 영역에 있어야 하고, 마우스 버튼은 이 이벤트가 발생하기 전에 다시 아래로 누르고 위로 누르면 됩니다.마우스가 GuiButton의 경계를 벗어나 해제되면 이벤트가 발생하지 않습니다.이 제한을 피하려면 MouseButton1Down 및 MouseButton1Up 을 사용할 수 있습니다; 이 이벤트는 비슷하지만, 사용자가 각각 왼쪽 마우스 버튼을 아래로 또는 위로 누르면 발생합니다.
MouseButton1Down
이 이벤트는 사용자가 GuiButton 에서 왼쪽 마우스 버튼을 누르면 발생합니다.
사용자가 와 를 누르고 왼쪽 마우스를 GuiButton 릴리스해야 하는 이벤트의 경우 MouseButton1Click 사용하여 이벤트가 발생하도록 고려하세요.
매개 변수
MouseButton1Up
이 이벤트는 사용자가 왼쪽 마우스 버튼을 해제할 때 발생합니다 GuiButton .
사용자가 와 를 누르고 왼쪽 마우스를 GuiButton 릴리스해야 하는 이벤트의 경우 MouseButton1Click 사용하여 이벤트가 발생하도록 고려하세요.
매개 변수
MouseButton2Click
이 이벤트는 사용자의 마우스가 완전히 오른쪽 클릭하여 GuiButton 를 클릭할 때 발생합니다.
클릭과 관련하여, 마우스는 GuiButton의 영역에 있어야 하고, 마우스 버튼은 이 이벤트가 발생하기 전에 다시 아래로 누르고 위로 누르면 됩니다.마우스가 GuiButton의 경계를 벗어나 해제되면 이벤트가 발생하지 않습니다.이 제한을 피하려면 MouseButton2Down 및 MouseButton2Up 을 사용할 수 있습니다; 이 이벤트는 비슷하지만, 사용자가 오른쪽 마우스 버튼을 아래로 또는 위로 누르면 발생합니다.
MouseButton2Down
이 이벤트는 사용자가 GuiButton 에서 오른쪽 마우스 버튼을 누르면 발생합니다.
사용자가 와 를 누르고 GuiButton 오른쪽 마우스를 릴리스해야 하는 이벤트의 경우 MouseButton2Click 사용하여 이벤트가 발생하도록 고려하십시오.
매개 변수
MouseButton2Up
이 이벤트는 사용자가 마우스 오른쪽 버튼을 해제할 때 발생합니다 GuiButton .
사용자가 와 를 누르고 GuiButton 오른쪽 마우스를 릴리스해야 하는 이벤트의 경우 MouseButton2Click 사용하여 이벤트가 발생하도록 고려하십시오.