BasePlayerGui

사용되지 않는 항목 표시

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

만들 수 없음

BasePlayerGui는 모든 GUI 렌더링 스토리지 클래스가 상속받는 추상 클래스입니다.

속성

메서드

GetGuiObjectsAtPosition

Instances

화면 위치를 가져오고 해당 화면 위치를 차지하고 있는 모든 GuiObject 인스턴스의 목록을 반환합니다. 목록은 순서대로 화면에서 첫 번째 및 마지막 인덱스로 표시됩니다.

주요 사용 사례는 플레이어의 마우스나 터치 입력을 통해 GUI 개체를 얻어 선택 또는 하이라이트와 같은 작업을 수행하는 것입니다. 이러한 효과는 GuiObject.MouseEnterGuiObject.MouseLeave를 사용하여 개발자가 이러한 이벤트

Class.BasePlayerGui의 자식 클래스는 이 함수를 상속하므로 PlayerGuiStarterGui 폴더와 같은 클래스 개체에서 실행할 수 있습니다.

매개 변수

Class.GuiService:GetGuiInset()|GuiInset 이 적용된 후 화면의 x 위치는 왼쪽 상단 모서리에 대해 Class.GuiService:GetGuiInset()|GuiInset 입니다.

Class.GuiService:GetGuiInset()|GuiInset 이 적용된 후 화면의 왼쪽 상단 모서리에 대한 y 위치.


반환

Instances

지정된 화면 공간을 차지하는 GuiObject 인스턴스의 테이블.

코드 샘플

Selecting GUIs at a Position

local UserInputService = game:GetService("UserInputService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
-- Create a Folder and ScreenGui to contain the highlight Frames
local highlights = Instance.new("Folder")
highlights.Name = "Highlights"
highlights.Parent = playerGui
local highlightsContainer = Instance.new("ScreenGui")
highlightsContainer.Name = "Container"
highlightsContainer.Parent = highlights
highlightsContainer.DisplayOrder = 99999
-- Creates a semi-transparent yellow Frame on top of the gui with the same AbsoluteSize and AbsolutePosition
local function highlightAsFrame(gui)
local highlight = Instance.new("Frame")
highlight.Name = "Highlight"
highlight.Parent = highlightsContainer
highlight.Size = UDim2.new(0, gui.AbsoluteSize.X, 0, gui.AbsoluteSize.Y)
highlight.Position = UDim2.new(0, gui.AbsolutePosition.X, 0, gui.AbsolutePosition.Y)
highlight.BackgroundColor3 = Color3.fromRGB(255, 255, 10) -- Yellow
highlight.BackgroundTransparency = 0.75
highlight.BorderSizePixel = 0
highlight.LayoutOrder = gui.LayoutOrder - 1
end
-- Use GetGuiObjectsAtPosition to get and highlight all GuiObjects at the input's position
local function highlightGui(input, _gameProcessed)
local pos = input.Position
local guisAtPosition = playerGui:GetGuiObjectsAtPosition(pos.X, pos.Y)
highlightsContainer:ClearAllChildren()
for _, gui in ipairs(guisAtPosition) do
if gui:IsA("GuiObject") then
highlightAsFrame(gui)
end
end
end
-- Fire highlightGui on InputBegan if input is of type MouseButton1 of Touch
local function InputBegan(input, gameProcessed)
local inputType = input.UserInputType
local touch = Enum.UserInputType.Touch
local mouse1 = Enum.UserInputType.MouseButton1
if inputType == touch or inputType == mouse1 then
highlightGui(input, gameProcessed)
end
end
UserInputService.InputBegan:Connect(InputBegan)

이벤트