배우기
엔진 클래스
GuiService
만들 수 없음
서비스
복제되지 않음

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.



API 참조
속성
AutoSelectGuiEnabled
병렬 읽기
기능: UI, Input
GuiService.AutoSelectGuiEnabled:boolean

CoreGuiNavigationEnabled
숨김
복제되지 않음
병렬 읽기
기능: UI, Input
GuiService.CoreGuiNavigationEnabled:boolean

GuiNavigationEnabled
병렬 읽기
기능: UI, Input
GuiService.GuiNavigationEnabled:boolean

IsModalDialog
사용되지 않음

IsWindows
사용되지 않음

MenuIsOpen
읽기 전용
복제되지 않음
병렬 읽기
기능: UI
GuiService.MenuIsOpen:boolean

PreferredTextSize
읽기 전용
복제되지 않음
병렬 읽기
기능: UI
GuiService.PreferredTextSize:Enum.PreferredTextSize
코드 샘플
선호 텍스트 크기 변경 감지/적용
local GuiService = game:GetService("GuiService")
local TextService = game:GetService("TextService")
local FONT_SIZE = 25
local PADDING = 8
local textLabel = Instance.new("TextLabel")
textLabel.Position = UDim2.new(0.5, 0, 0.5, 0)
textLabel.AnchorPoint = Vector2.new(0.5, 0.5)
textLabel.AutomaticSize = Enum.AutomaticSize.X
textLabel.TextSize = FONT_SIZE + PADDING
textLabel.Text = "텍스트 레이블 테스트"
textLabel.Parent = script.Parent
local function applyAddedTextHeight()
local finalTextHeight = TextService:GetTextSize("", FONT_SIZE, Enum.Font.BuilderSans, Vector2.new(math.huge, math.huge)).Y
local addedTextHeight = finalTextHeight - FONT_SIZE
print("선호 텍스트 크기가 기본 텍스트 크기에", addedTextHeight, "를 추가합니다")
textLabel.Size = UDim2.new(0, 0, 0, FONT_SIZE + addedTextHeight + PADDING)
end
applyAddedTextHeight()
GuiService:GetPropertyChangedSignal("PreferredTextSize"):Connect(applyAddedTextHeight)

PreferredTransparency
숨김
읽기 전용
복제되지 않음
병렬 읽기
기능: UI
GuiService.PreferredTransparency:number
코드 샘플
선호 투명도 변경 감지/적용
local GuiService = game:GetService("GuiService")
local CollectionService = game:GetService("CollectionService")
local TAG = "TransparentBack"
local transparentBackObjects = {}
local function onInstanceAdded(object)
if object.BackgroundTransparency then
local defaultTransparency = object.BackgroundTransparency
transparentBackObjects[object] = defaultTransparency
object.BackgroundTransparency = defaultTransparency * GuiService.PreferredTransparency
end
end
local function onInstanceRemoved(object)
transparentBackObjects[object] = nil
end
-- 초기 태그가 있는 인스턴스 저장
for _, object in CollectionService:GetTagged(TAG) do
onInstanceAdded(object)
end
-- 태그가 있는 인스턴스가 추가되거나 제거될 때 감지
CollectionService:GetInstanceAddedSignal(TAG):Connect(onInstanceAdded)
CollectionService:GetInstanceRemovedSignal(TAG):Connect(onInstanceRemoved)
-- 게임 내 설정이 변경될 때, 태그가 있는 인스턴스 조정
GuiService:GetPropertyChangedSignal("PreferredTransparency"):Connect(function()
for object, defaultTransparency in transparentBackObjects do
object.BackgroundTransparency = defaultTransparency * GuiService.PreferredTransparency
end
end)

ReducedMotionEnabled
숨김
읽기 전용
복제되지 않음
병렬 읽기
기능: UI
GuiService.ReducedMotionEnabled:boolean

SelectedObject
병렬 읽기
기능: UI, Input
GuiService.SelectedObject:GuiObject
코드 샘플
게임패드 선택 변경 시 출력하기
local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("SelectedObject가 변경되었습니다!")
end
end
GuiService.Changed:Connect(printChanged)

TopbarInset
읽기 전용
복제되지 않음
병렬 읽기
기능: UI
GuiService.TopbarInset:Rect
코드 샘플
사용 가능한 상단 바 공간 내의 반응형 프레임
local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local screenGui = Instance.new("ScreenGui")
screenGui.IgnoreGuiInset = true
screenGui.Parent = Players.LocalPlayer.PlayerGui
local frame = Instance.new("Frame")
frame.BackgroundColor3 = Color3.fromRGB(0, 255, 0)
frame.Parent = screenGui
GuiService:GetPropertyChangedSignal("TopbarInset"):Connect(function()
local inset = GuiService.TopbarInset
frame.Size = UDim2.new(0, inset.Width, 0, inset.Height)
frame.Position = UDim2.new(0, inset.Min.X, 0, inset.Min.Y)
end)

TouchControlsEnabled
병렬 읽기
기능: UI, Input
GuiService.TouchControlsEnabled:boolean

ViewportDisplaySize
읽기 전용
복제되지 않음
병렬 읽기
기능: UI
GuiService.ViewportDisplaySize:Enum.DisplaySize
코드 샘플
뷰포트 디스플레이 크기 변경
local GuiService = game:GetService("GuiService")
local function updateUI()
if (GuiService.ViewportDisplaySize == Enum.DisplaySize.Small) then
-- UI를 작은 화면에 맞게 업데이트합니다.
elseif (GuiService.ViewportDisplaySize == Enum.DisplaySize.Large) then
-- UI를 큰 화면에 맞게 업데이트합니다.
else
-- UI를 중간/기본 화면에 맞게 업데이트합니다.
end
end
GuiService:GetPropertyChangedSignal("ViewportDisplaySize"):Connect(updateUI)
updateUI()

메서드
AddSelectionParent
사용되지 않음

AddSelectionTuple
사용되지 않음

CloseInspectMenu
기능: UI
GuiService:CloseInspectMenu():()
반환
()

DismissNotification
기능: UI
GuiService:DismissNotification(notificationId:string):boolean
매개 변수
notificationId:string
반환

GetEmotesMenuOpen
기능: UI
GuiService:GetEmotesMenuOpen():boolean
반환

GetGameplayPausedNotificationEnabled
기능: UI
GuiService:GetGameplayPausedNotificationEnabled():boolean
반환

GetGuiInset
기능: UI
GuiService:GetGuiInset():Tuple
반환

GetInsetArea
기능: UI
GuiService:GetInsetArea(screenInsets:Enum.ScreenInsets):Rect
매개 변수
screenInsets:Enum.ScreenInsets
반환

GetInspectMenuEnabled
기능: UI
GuiService:GetInspectMenuEnabled():boolean
반환

InspectPlayerFromHumanoidDescription
기능: UI, AvatarAppearance
GuiService:InspectPlayerFromHumanoidDescription(
humanoidDescription:Instance, name:string
):()
매개 변수
humanoidDescription:Instance
name:string
반환
()
코드 샘플
휴머노이드 설명으로 검사 메뉴 열기
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

InspectPlayerFromUserId
기능: UI, AvatarAppearance
GuiService:InspectPlayerFromUserId(userId:User):()
매개 변수
userId:User
반환
()
코드 샘플
사용자 ID의 검토 메뉴 열기
local GuiService = game:GetService("GuiService")
-- 772462 사용자 ID로 플레이어 검사
GuiService:InspectPlayerFromUserId(772462)

IsTenFootInterface
사용되지 않음

RemoveSelectionGroup
사용되지 않음

Select
기능: UI
GuiService:Select(selectionParent:Instance):()
매개 변수
selectionParent:Instance
반환
()

SendNotification
기능: UI
GuiService:SendNotification(notificationInfo:Dictionary):string
매개 변수
notificationInfo:Dictionary
반환

SetEmotesMenuOpen
기능: UI
GuiService:SetEmotesMenuOpen(isOpen:boolean):()
매개 변수
isOpen:boolean
반환
()

SetGameplayPausedNotificationEnabled
기능: UI
GuiService:SetGameplayPausedNotificationEnabled(enabled:boolean):()
매개 변수
enabled:boolean
반환
()

SetInspectMenuEnabled
기능: UI
GuiService:SetInspectMenuEnabled(enabled:boolean):()
매개 변수
enabled:boolean
반환
()

이벤트
MenuClosed
기능: UI
GuiService.MenuClosed():RBXScriptSignal

MenuOpened
기능: UI
GuiService.MenuOpened():RBXScriptSignal

©2026 Roblox Corporation. Roblox 및 Roblox 로고, 'Powering Imagination'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.