GuiService

Si activé, le bouton Select sur une manette de jeu ou Backslash définira automatiquement une interface graphique comme objet sélectionné.Désactiver cela signifiera que la navigation Gui fonctionnera toujours si GuiService.GuiNavigationEnabled est activé, mais vous devrez définir GuiService.SelectedObject manuellement pour démarrer la navigation Gui.

Active si les objets dans le CoreGui peuvent être navigés ou non à l'aide d'une manette de jeu.

Utilisé pour activer et désactiver la navigation du contrôleur par défaut GUI.

Retourne vrai si un menu de CoreGui est ouvert.

Obtient la transparence préférée de l'utilisateur comme un nombre entre 0 et 1, ce qui indique à quel point ils veulent que le fond des éléments d'interface utilisateur soit plus opaque.Défaut à 1.

Cette valeur de retour reflète un paramètre qui peut être défini du côté de l'utilisateur dans les paramètres de l'application ou dans le menu des paramètres d'expérience via transparence arrière .La valeur par défaut est 1, ce qui indique que l'utilisateur préfère la transparence du fond par défaut.La valeur la plus basse est 0, ce qui indique que l'utilisateur préfère que les arrière-plans soient entièrement opaques, améliorant la lisibilité et le contraste pour l'interface utilisateur affectée.Multiplier l'élément GuiObject.BackgroundTransparency avec la valeur retournée de PreferredTransparency est la façon recommandée d'utiliser ce paramètre ; les arrière-plans deviendront plus opaques au fur et à mesure que PreferredTransparency approche 0.Cela devrait être utilisé avec Object:GetPropertyChangedSignal() afin qu'il soit mis à jour automatiquement lorsque l'utilisateur modifie sa transparence préférée.

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()

Retourne true si l'utilisateur a activé la mobilité réduite. Par défaut, c'est false .

Cette valeur de retour reflète un paramètre qui peut être défini du côté de l'utilisateur dans les paramètres de l'application ou dans le menu des paramètres d'expérience via réduire le mouvement .Une valeur de true indique que l'utilisateur souhaite que les effets de mouvement et les animations soient réduits ou supprimés complètement.

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

Définit le GuiObject actuellement mis en évidence par le navigateur GUI (utilisé pour les Gamepads). Cela peut être réinitialisé à nil si l'objet est hors écran.

Cette propriété est modifiée par les événements GuiObject.SelectionGained et GuiObject.SelectionLost.

Si vous souhaitez déterminer quand cette propriété change sans suivre les événements SelectionGained et SelectionLost pour tous les éléments de l'interface graphique, vous pouvez utiliser l'événement Changed.

local GuiService = game:GetService("GuiService")

local function printChanged(value)
	if value == "SelectedObject" then
		print("The SelectedObject changed!")
	end
end

GuiService.Changed:Connect(printChanged)

Renvoie un objet Rect représentant la zone non occupée entre les contrôles les plus à gauche de Roblox et le bord de la zone de sécurité de l'appareil.

La valeur est dynamique et peut être attendue à changer en fonction de la visibilité des contrôles d'interface utilisateur tels que le changement de la propriété Health du joueur local, de l'utilisation de StarterGui:SetCoreGuiEnabled() , du changement de la taille et de la position des contrôles d'interface utilisateur Roblox, et/ou d'autres.Pour cette raison, il est recommandé de détecter et de réagir aux modifications de cette propriété avec Object:GetPropertyChangedSignal() .

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)

Utilisé pour activer et désactiver les contrôles tactiles et l'interface utilisateur de visualisation des contrôles tactiles. Par défaut, c'est vrai.

Cette fonction ferme le menu d'inspection, s'il est ouvert, lorsqu'il est exécuté à partir d'un LocalScript .

Voir aussi :

• Menu d'inspection d'avatar, un article fournissant une explication plus détaillée de la fonction d'inspection et de l'achat et de la façon dont elle fonctionne
• GuiService:InspectPlayerFromHumanoidDescription() , permet à un développeur d'ouvrir le menu Inspect montrant les ressources listées dans cet objet HumanoidDescription.Ceci est particulièrement utile lorsque ce qui est porté sur l'avatar d'un joueur sur la plate-forme Roblox n'est pas nécessairement le même que son apparence dans le jeu
• GuiService:InspectPlayerFromUserId() , permet au menu d'inspection d'apparaître en montrant à l'utilisateur qui a le UserId donné.Cela est particulièrement utile lorsque vous voulez inspecter des joueurs qui ne sont pas dans le jeu actuel

Retours

Paramètres

Retours

Renvoie un booléen indiquant si le menu Emotes du joueur est ouvert ou non.

Les développeurs peuvent ouvrir ou fermer le menu d'émotes en appelant la fonction GuiService:SetEmotesMenuOpen().

Retours

Cette fonction renvoie si oui ou non la notification gameplay paused a été désactivée par le développeur.

Les développeurs peuvent activer ou désactiver la notification en appelant la fonction GuiService:SetGameplayPausedNotificationEnabled().

Voir aussi :

• Workspace.StreamingIntegrityMode et Enum.StreamingIntegrityMode pour plus de détails sur le moment où le jeu est interrompu.

Retours

Renvoie deux valeurs Vector2 représentant l'insertion des interfaces utilisateur en pixels, du coin supérieur gauche de l'écran et du coin inférieur droit de l'écran respectivement.

Les valeurs d'insertion fournies par cette fonction ne prennent effet que sur ScreenGuis celles qui ont leur propriété IgnoreGuiInset définie sur false.

Retours

Cette fonction renvoie si la fonctionnalité du menu d'inspection et d'achat est actuellement activée.La fonctionnalité est activée par défaut et peut être définie en utilisant la fonction GuiService:SetInspectMenuEnabled().

Voir aussi :

• Menu d'inspection d'avatar, un article fournissant une explication plus détaillée de la fonction d'inspection et de l'achat et de la façon dont elle fonctionne
• GuiService:InspectPlayerFromHumanoidDescription() , permet à un développeur d'ouvrir le menu Inspect montrant les ressources listées dans cet objet HumanoidDescription.Ceci est particulièrement utile lorsque ce qui est porté sur l'avatar d'un joueur sur la plate-forme Roblox n'est pas nécessairement le même que son apparence dans le jeu
• GuiService:InspectPlayerFromUserId() , permet au menu d'inspection d'apparaître en montrant à l'utilisateur qui a le UserId donné.Cela est particulièrement utile lorsque vous voulez inspecter des joueurs qui ne sont pas dans le jeu actuel

Retours

Cette fonction permet à un développeur d'ouvrir le menu Inspect montrant les ressources listées dans cet HumanoidDescription.

Cela permet une plus grande personnalisation avec ce qui est affiché dans le menu d'inspection lorsque les joueurs inspectent d'autres joueurs dans votre jeu.Si votre jeu modifie ce que les joueurs portent, vous pouvez plutôt donner à l'inspecteur un objet de description humanoïde qui représente ce que porte un joueur et ces articles seront affichés.Vous devez également passer un nom pour représenter le nom du joueur qui sera inspecté.

Voir aussi :

• Menu d'inspection d'avatar, un article fournissant une explication plus détaillée de la fonction d'inspection et de l'achat et de la façon dont elle fonctionne
• GuiService:SetInspectMenuEnabled() , permet aux développeurs d'activer ou de désactiver la fonctionnalité d'inspection et d'achat par défaut
• GuiService:InspectPlayerFromUserId() , permet au menu d'inspection d'apparaître en montrant à l'utilisateur qui a le UserId donné.Cela est particulièrement utile lorsque vous voulez inspecter des joueurs qui ne sont pas dans le jeu actuel.

Paramètres

Retours

local GuiService = game:GetService("GuiService")

local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"

GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

Cette fonction permet au menu d'inspection d'apparaître en montrant à l'utilisateur qui a le UserId donné.Cela est particulièrement utile lorsque vous voulez inspecter des joueurs qui ne sont pas dans le jeu actuel.

Cela affiche les mêmes informations que l'onglet "Porte actuellement" sur le profil de l'utilisateur spécifié.

Voir aussi :

• Menu d'inspection d'avatar, un article fournissant une explication plus détaillée de la fonction d'inspection et de l'achat et de la façon dont elle fonctionne
• GuiService:SetInspectMenuEnabled() , permet aux développeurs d'activer ou de désactiver la fonctionnalité d'inspection et d'achat par défaut.Ceci est particulièrement utile lorsque ce qui est porté sur l'avatar d'un joueur sur la plate-forme Roblox n'est pas nécessairement le même que son apparence dans le jeu
• GuiService:InspectPlayerFromHumanoidDescription() , permet à un développeur d'ouvrir le menu Inspect montrant les ressources listées dans cet objet HumanoidDescription

Paramètres

Retours

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

Renvoie vrai si le client utilise l'interface de dix pieds, qui est une version spéciale de l'interface utilisateur de Roblox, exclusive aux consoles.C'est la seule façon garantie de vérifier si l'utilisateur est sur une console ou non.

Retours

Lorsque Select est appelé sur une sélection d'instanceParent qui est PlayerGui ou un descendant de PlayerGui, le moteur recherche tous les GuiObjects sélectionnables, visibles et à l'écran disponibles qui sont des descendants de selectionParent et définit le GuiService.SelectedObject sur le GuiObject avec le plus petit GuiService.SelectionOrder.

Paramètres

Retours

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()

Paramètres

Retours

Ouvre ou ferme le menu Emotes du joueur.

Paramètres

Retours

Cette méthode permet aux développeurs de désactiver la notification intégrée lorsque le jeu d'un joueur est interrompu.Ils peuvent ensuite ajouter leur propre interface utilisateur s'ils souhaitent la personnaliser.

Les développeurs peuvent demander si la notification est activée en appelant la fonction GuiService:GetGameplayPausedNotificationEnabled().

Voir aussi :

• Workspace.StreamingIntegrityMode et Enum.StreamingIntegrityMode pour plus de détails sur le moment où le jeu est interrompu.

Paramètres

Retours

Cette fonction permet aux développeurs d'activer ou de désactiver la fonction d'inspection et d'achat par défaut.Cela est utile lorsque vous souhaitez désactiver la fonctionnalité dans votre jeu, entièrement ou pendant certaines parties de votre jeu (comme une scène coupée).La fonction est activée par défaut.

L'exemple de code ci-dessous montre comment désactiver le menu d'inspection pour votre jeu :

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

Voir aussi :

• Menu d'inspection d'avatar, un article fournissant une explication plus détaillée de la fonction d'inspection et de l'achat et de la façon dont elle fonctionne
• GuiService:InspectPlayerFromHumanoidDescription() , permet à un développeur d'ouvrir le menu Inspect montrant les ressources listées dans cet objet HumanoidDescription.Ceci est particulièrement utile lorsque ce qui est porté sur l'avatar d'un joueur sur la plate-forme Roblox n'est pas nécessairement le même que son apparence dans le jeu
• GuiService:InspectPlayerFromUserId() , permet au menu d'inspection d'apparaître en montrant à l'utilisateur qui a le UserId donné.Cela est particulièrement utile lorsque vous voulez inspecter des joueurs qui ne sont pas dans le jeu actuel

Paramètres

Retours

S'enflamme lorsque l'utilisateur ferme le menu d'évasion du noyau Roblox.

Se déclenche lorsque l'utilisateur ouvre le menu d'évasion du noyau Roblox.