ScreenGui 는 사용자의 화면에 표시된 2D GuiObjects 용 저장소 컨테이너입니다.A ScreenGui 는 플레이어의 PlayerGui 에 부모로 지정되는 경우에만 표시됩니다; 플레이어의 ScreenGui 에 StarterGui 를 부모로 지정하면 경험에 참여하고 캐릭터가 처음 생성될 때 각 플레이어의 PlayerGui 에 클론이 생성됩니다.자세한 내용은 화면 UI 컨테이너를 참조하십시오.
성능 향상을 위해, 다음 이벤트 중 하나가 발생할 때까지 ScreenGui의 모양이 캐시됩니다:
- 후손이 추가되거나 제거됩니다.
- 하위 요소의 속성이 변경됩니다.
- ScreenGui 자체의 속성이 변경됩니다.
이러한 이벤트 중 하나가 발생하면 렌더링된 다음 프레임에서 ScreenGui 모양이 다시 계산됩니다.
요약
속성
이 ScreenGui 의 콘텐츠를 기기안전 영역에 클립할지 여부.
여러 ScreenGui 컨테이너가 그려지는 Z-인덱스 순서를 제어합니다.
ScreenGui가 Roblox의 핵심 UI 요소 범위로 오버플로되는지 여부를 결정합니다.
자동 UI 호환 변환이 화면 잘리기가 있는 디스플레이에 적용되는지 여부를 지정합니다. specifies whether automatic UI compatibility transformations are applied to descendant "전체 화면" GuiObjects on displays with screen cutouts.
ScreenGui의 콘텐츠에 적용되는 안전 영역 삽입을 제어합니다.
이 LayerCollector 의 표시 여부를 전환합니다.
플레이어의 캐릭터가 재생성될 때마다 리셋(자체를 삭제하고 플레이어의 캐릭터로 다시 클론화)되는지 여부를 결정합니다.
이 GuiObject.ZIndex 의 모든 하위에서 어떻게 작동하는지 제어합니다. LayerCollector .
픽셀로 표시되는 실제 화면 위치의 GuiBase2d 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소 요소
GuiBase2d 요소의 실제 화면 회전을 도 단위로 설명합니다.
픽셀로 표시되는 실제 화면 크기의 GuiBase2d 요소를 설명합니다.
true 로 설정되면 지역화가 이 GuiBase2d 및 그 하위에 적용됩니다.
이 GuiBase2d 및 그 하위에 자동화된 로캘리제이션을 적용하기 위해 사용할 LocalizationTable 참조.
아래쪽 방향으로 게임패드 선택 행동을 사용자 지정합니다.
왼쪽 방향에서 게임패드 선택 동작을 사용자 지정합니다.
오른쪽 방향으로 게임패드 선택 행동을 사용자 지정합니다.
위쪽으로 게임패드 선택 행동을 사용자 지정합니다.
게임패드 선택 이동을 사용자 지정할 수 있습니다.
이벤트
이벤트가 GuiBase2d에서 상속되었습니다- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
연결된 게임패드 선택이 이동하거나, 나가거나, 변경되면 발생합니다. GuiBase2d 또는 모든 하위 요소에서 GuiObjects 입니다.
속성
ClipToDeviceSafeArea
이 속성이 인 경우, 의 모든 후손이 기기안전 영역에 클리핑됩니다(참조 ).기본값은 true 이며, 필요할 때 화면 가장자리에서 슬라이드하여 표시되는 의도적으로 숨겨진 UI의 이전 버전 호환성을 유지합니다.
이 속성이 인 경우, 하위 요소는 기기안전 영역에 클립되지 않으며 카메라 노치 또는 기타 화면 잘라내기로 가려질 수 있습니다.
이 속성은 ScreenInsets 를 None 로 설정하면 무시되므로, 이렇게 하면 의도적으로 기기안전 삽입을 무시하려는 것으로 간주됩니다.
DisplayOrder
이 속성은 여러 ScreenGui 컨테이너가 그려지는 Z-인덱스 순서를 제어합니다.더 높은 DisplayOrder 가진 사람들은 더 낮은 값을 가진 사람들 위에 그려집니다.
IgnoreGuiInset
이 속성이 false(기본값)이면 ScreenInsets가 CoreUISafeInsets로 설정되어 Roblox 상단 바 핵심 UI 아래에서 경계를 유지합니다.
이 속성이 true 로 변경되고 ScreenInsets 가 CoreUISafeInsets 로 설정되어 있으면 ScreenInsets 가 DeviceSafeInsets 로 설정됩니다.
화면 삽입이 ScreenInsets 의 콘텐츠에 어떻게 영향을 미치는지 자세히 알아보려면 ScreenGui 을 참조하십시오.
SafeAreaCompatibility
이 속성은 자동 UI 호환 변환이 디스플레이에 스크린 컷아웃이 있는 경우 후손의 "전체화면"에 적용되는지 여부를 지정합니다 GuiObjects 의 ScreenGui 에 디스플레이에 표시됩니다.적격성은 하위 요소의 총 면적 GuiObject (적용된 경계 또는 UIStroke 포함)이 수평 및 세로 방향으로 기기안전 영역을 덮는 경우 발생합니다.자세한 내용은 Enum.SafeAreaCompatibility 열거형 참조를 참조하십시오.
기본값은 중단 없이 화면에 작성된 UI의 모양을 자동으로 개선하기 위해 FullscreenExtension입니다.그러나 새로운 작업에 전체화면 확장을 피하는 것이 좋습니다; 대신, ScreenInsets 속성을 사용하여 다른 ScreenGui 컨테이너에 존중해야 할 삽입을 지정합니다.
내려오는 UI 개체가 기기안전 영역에 의해 계속 잘리면 ClipToDeviceSafeArea 가 true로 설정되어 있으면 참고하십시오.
ScreenInsets
이 속성은 콘텐츠의 ScreenGui에 적용되는 안전 영역 삽입을 제어합니다.
기본값인 CoreUISafeInsets는 모든 하위 요소를 GuiObjects 코어 UI 안전 영역 내에 유지하고 Roblox 상단 표시줄 버튼 및 기기의 카메라 노치와 같은 다른 화면 잘라내기에서 제거합니다.
이 속성을 None로 설정하면 UI 개체가 핵심 UI 개체나 카메라 노치와 같은 장치 컷아웃 뒤에 가려질 수 있습니다.결과적으로, 배경 이미지와 같은 비인터랙티브 콘텐츠가 포함된 None에는 ScreenGui만 사용해야 합니다.
대체 예시는 화면 UI 컨테이너를 참조하십시오.