GuiService

Visualizza obsoleti
Non costruibile
Assistenza
Non Replicato

GuiService allows developers to control what GuiObject is currently being selected by the gamepad navigator, as well as check if Roblox's main menu is currently open.

Sommario

Proprietà

  • Lettura Parallela

    If activated, the Select button on a Gamepad or Backslash will automatically set a GUI as the selected object.

  • Nascosto
    Non Replicato
    Lettura Parallela

    Toggles whether or not objects in the CoreGui can be navigated using a Gamepad.

  • Lettura Parallela

    Used to enable and disable the default controller GUI navigation.

  • Sola Lettura
    Non Replicato
    Lettura Parallela

    Returns true if any menu of CoreGui is open.

  • Sola Lettura
    Non Replicato
    Lettura Parallela
  • Nascosto
    Sola Lettura
    Non Replicato
    Lettura Parallela

    Gets the user's preferred transparency as a number between 0 and 1, which indicates how opaque they want the backgrounds of certain UI elements to be. The recommended usage is as a multiplier of an element's BackgroundTransparency. Defaults to 1.

  • Nascosto
    Sola Lettura
    Non Replicato
    Lettura Parallela

    Returns true if the user has enabled reduced motion. Defaults to false.

  • Lettura Parallela

    Sets the GuiObject currently being focused on by the GUI Navigator (used for Gamepads).

  • Sola Lettura
    Non Replicato
    Lettura Parallela

    Used to determine the absolute size and position of unobstructed area within top bar space.

  • Lettura Parallela

    Used to enable and disable touch controls and touch control display UI. Defaults to true.

Metodi

Eventi

Proprietà

AutoSelectGuiEnabled

Lettura Parallela

If activated, the Select button on a Gamepad or Backslash will automatically set a GUI as the selected object. Turning this off will mean that Gui navigation will still work if GuiService.GuiNavigationEnabled is enabled but you will have to set GuiService.SelectedObject manually to start Gui navigation.

CoreGuiNavigationEnabled

Nascosto
Non Replicato
Lettura Parallela

Toggles whether or not objects in the CoreGui can be navigated using a Gamepad.

GuiNavigationEnabled

Lettura Parallela

Used to enable and disable the default controller GUI navigation.

Sola Lettura
Non Replicato
Lettura Parallela

Returns true if any menu of CoreGui is open.

PreferredTextSize

Sola Lettura
Non Replicato
Lettura Parallela

PreferredTransparency

Nascosto
Sola Lettura
Non Replicato
Lettura Parallela

Gets the user's preferred transparency as a number between 0 and 1, which indicates how much more opaque they want the background of UI elements to be. Defaults to 1.

This return value reflects a setting which can be set from the user's side in either the app settings or within the in-experience settings menu via Background Transparency. The default value is 1, indicating that the user prefers the default background transparency. The lowest value is 0, indicating that the user prefers backgrounds to be completely opaque, improving readability and contrast for affected UI. Multiplying an element's GuiObject.BackgroundTransparency with the value returned from PreferredTransparency is the recommended way to use this setting; backgrounds will become more opaque as PreferredTransparency approaches 0. This should be used with Object:GetPropertyChangedSignal() so that it automatically updates when the user changes their preferred transparency.

Campioni di codice

Use Preferred Transparency

local DEFAULT_TRANSPARENCY = 0.5
local frame = script.Parent
local function setBackgroundTransparency()
frame.BackgroundTransparency = DEFAULT_TRANSPARENCY * GuiService.PreferredTransparency
end
GuiService:GetPropertyChangedSignal("PreferredTransparency"):Connect(setBackgroundTransparency)
setBackgroundTransparency()

ReducedMotionEnabled

Nascosto
Sola Lettura
Non Replicato
Lettura Parallela

Returns true if the user has enabled reduced motion. Defaults to false.

This return value reflects a setting which can be set from the user's side in either the app settings or within the in-experience settings menu via Reduce Motion. A value of true indicates that the user wants motion effects and animations to be reduced or completely removed.

Campioni di codice

Use Reduced Motion

local DEFAULT_TRANSPARENCY = 0.5
local frame = script.Parent
local endPosition = UDim2.fromScale(0.5, 0.8)
if GuiService.ReducedMotionEnabled then
frame.Position = endPosition
else
local moveTweenInfo = TweenInfo.new(0.5)
local moveTweenProps = {
Position = endPosition
}
local moveTween = TweenService:Create(frame, slideInTweenInfo, slideInTweenProps)
moveTween:Play()
end

SelectedObject

Lettura Parallela

Sets the GuiObject currently being focused on by the GUI Navigator (used for Gamepads). This may reset to nil if the object is off-screen.

This property is changed by the GuiObject.SelectionGained and GuiObject.SelectionLost events.

If you would like to determine when this property changes without tracking the SelectionGained and SelectionLost events for all GUI elements, you can use the Changed event.

Campioni di codice

Printing When Gamepad Selection Changes

local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)

TopbarInset

Sola Lettura
Non Replicato
Lettura Parallela

Returns a Rect object representing the unoccupied area between the Roblox left-most controls and the edge of the device safe area.

The value is dynamic and can be expected to change based on the visibility of UI controls such as changing the local player's Health property, usage of StarterGui:SetCoreGuiEnabled(), changing the size and position of Roblox UI Controls, and/or others. For this reason, it's recommend that you detect and react to changes of this property with Object:GetPropertyChangedSignal().

Campioni di codice

Responsive Frame Within Available Top Bar Space

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

Lettura Parallela

Used to enable and disable touch controls and touch control display UI. Defaults to true.

Metodi

CloseInspectMenu

void

This function closes the Inspect Menu, if open, when run from a LocalScript.

See also:


Restituzioni

void

DismissNotification

Parametri

notificationId: string

Restituzioni

GetEmotesMenuOpen

Returns a boolean indicating whether or not the player Emotes menu is open.

Developers can open or close the Emotes menu by calling the GuiService:SetEmotesMenuOpen() function.


Restituzioni

Indicates whether the Emotes menu is open.

GetGameplayPausedNotificationEnabled

This function returns whether or not the gameplay paused notification has been disabled by the developer.

Developers can enable or disable the notification by calling the GuiService:SetGameplayPausedNotificationEnabled() function.

See also:


Restituzioni

Whether or not the gameplay paused notification has been disabled.

GetGuiInset

Returns two Vector2 values representing the inset of user GUIs in pixels, from the top left corner of the screen and the bottom right corner of the screen respectively.

The inset values supplied by this function only take effect on ScreenGuis that have their IgnoreGuiInset property set to false.


Restituzioni

A tuple of two Vector2 values describing the current specified Gui Inset.

GetInspectMenuEnabled

This function returns whether the Inspect and Buy menu functionality is currently enabled. The feature is enabled by default and can be set using the GuiService:SetInspectMenuEnabled() function.

See also:


Restituzioni

A boolean indicating whether the Inspect Menu feature is enabled.

InspectPlayerFromHumanoidDescription

void

This function allows a developer to bring up the Inspect menu showing the assets listed in this HumanoidDescription object.

This allows further customization with what is shown in the Inspect Menu when players inspect other players in your game. If your game modifies what the players are wearing, you can instead give the Inspect Menu a HumanoidDescription object that represents what a player is wearing and those items will be shown. You should pass a name as well to represent the name of the player that will be inspected.

See also:

Parametri

humanoidDescription: Instance

A HumanoidDescription object that contains the assets to show in the Inspect menu.

name: string

The name of the player being Inspected to show in the Inspect menu.


Restituzioni

void

Campioni di codice

Opening an Inspect Menu with a HumanoidDescription

local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

InspectPlayerFromUserId

void

This function allows the Inspect Menu to appear showing the user that has the given UserId. This is especially useful when you want to inspect players who aren't in the current game.

This shows the same information as the "Currently Wearing" tab on the specified user's profile.

See also:

Parametri

userId: number

The UserId of the player to inspect.


Restituzioni

void

Campioni di codice

Opening the Inspect Menu for a UserId

local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)

IsTenFootInterface

Returns true if the client is using the ten foot interface, which is a special version of Roblox's UI, exclusive to consoles. This is the only guaranteed way to verify if the user is on a console or not.


Restituzioni

Select

void

When Select is called on an instance selectionParent that is PlayerGui or a descendant of PlayerGui, the engine searches all available selectable, visible and on-screen GuiObjects that are descendants of selectionParent and sets the GuiService.SelectedObject to the GuiObject with the smallest GuiService.SelectionOrder.

Parametri

selectionParent: Instance

The parent of selection whose descendants are searched.


Restituzioni

void

Campioni di codice

Use Preferred Transparency

local DEFAULT_TRANSPARENCY = 0.5
local frame = script.Parent
local function setBackgroundTransparency()
frame.BackgroundTransparency = DEFAULT_TRANSPARENCY * GuiService.PreferredTransparency
end
GuiService:GetPropertyChangedSignal("PreferredTransparency"):Connect(setBackgroundTransparency)
setBackgroundTransparency()

SendNotification

Parametri

notificationInfo: Dictionary

Restituzioni

SetEmotesMenuOpen

void

Opens or closes the player Emotes menu.

Parametri

isOpen: bool

Restituzioni

void

SetGameplayPausedNotificationEnabled

void

This method allows developers to disable the built-in notification when a players gameplay is paused. They can then add in their own UI if they wish to customize it.

Developers can query whether the notification is enabled by calling the GuiService:GetGameplayPausedNotificationEnabled() function.

See also:

Parametri

enabled: bool

Whether or not the built-in notification GUI is disabled.


Restituzioni

void

SetInspectMenuEnabled

void

This function allows developers to enable or disable default Inspect and Buy functionality. This is useful when you want to disable the feature in your game, entirely or during certain parts of your game (such as a cutscene). The feature is enabled by default.

The code sample below demonstrates how to disable the Inspect Menu for your game:


local GuiService = game:GetService("GuiService")
GuiService:SetInspectMenuEnabled(false)

See also:

Parametri

enabled: bool

A boolean indicating whether to enable or disable the Inspect Menu feature.


Restituzioni

void

Eventi

Fires when the user closes the Roblox coregui escape menu.


Fires when the user opens the Roblox coregui escape menu.