ScreenGui
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
ScreenGui é um contêiner de armazenamento para 2D GuiObjects exibido na tela do usuário.A ScreenGui apenas mostra se for parente de um jogador de PlayerGui ; parenterizar um ScreenGui para StarterGui garante que ele seja clonado em cada jogador de PlayerGui quando eles se juntarem à experiência e seu personagem primeiro spawnar.Veja Contêineres de UI na tela para mais detalhes.
Para melhorias de desempenho, a aparência de um ScreenGui é armazenada até que um dos seguintes eventos ocorra:
- Um descendente é adicionado ou removido dele.
- Uma propriedade de um descendente muda.
- Uma propriedade da própria ScreenGui muda.
Se qualquer um desses eventos ocorrer, a aparência ScreenGui será recalculada no próximo quadro que for renderizado.
Resumo
Propriedades
Se clipar o conteúdo deste ScreenGui para a área segura do dispositivo.
Controla a ordem do índice Z em que vários contêineres ScreenGui são desenhados.
Determina se o ScreenGui transborda para o alcance dos elementos de UI principais do Roblox.
Especifica se transformações de compatibilidade de UI automática são aplicadas ao descendente "tela cheia" em displays com cortes de tela.
Controla as inserções de área segura que são aplicadas ao conteúdo do ScreenGui .
Alterna a visibilidade deste LayerCollector .
Determina se os ressets (se reinicia e se clona de novo no personagem do jogador) ocorrem sempre que o personagem do jogador respawna.
Controla como GuiObject.ZIndex se comporta em todos os descendentes deste LayerCollector .
Descreve a posição real da tela de um elemento GuiBase2d , em pixels.
Descreve a rotação real da tela de um elemento GuiBase2d em graus.
Descreve o tamanho real da tela de um elemento GuiBase2d , em pixels.
Quando definido para true , a localização será aplicada a este GuiBase2d e seus descendentes.
Uma referência a um LocalizationTable para ser usado para aplicar localização automatizada a este GuiBase2d e seus descendentes.
Personaliza o comportamento de seleção de gamepad na direção de baixo.
Personaliza o comportamento de seleção do gamepad na direção esquerda.
Personaliza o comportamento de seleção do gamepad na direção certa.
Personaliza o comportamento de seleção do gamepad na direção de cima.
Permite a personalização do movimento de seleção do gamepad.
Eventos
Eventos herdados de GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Incêndios quando a seleção do gamepad se move para, deixa ou muda dentro do conectado GuiBase2d ou qualquer descendente GuiObjects.
Propriedades
ClipToDeviceSafeArea
Se esta propriedade for true, todos os descendentes GuiObject do ScreenGui serão clipsados na área segura do dispositivo (veja Enum.ScreenInsets ).O padrão é true manter a compatibilidade com versões anteriores da interface que é intencionalmente oculta fora da tela, como objetos que deslizam para a visualização a partir de uma borda da tela quando são necessários.
Se esta propriedade for , os descendentes não serão clipsados na área segura do dispositivo e podem ser obscurecidos pela ranhura da câmera ou outros cortes de tela.
Observe que essa propriedade será ignorada se você definir ScreenInsets para None , pois isso implica que você quer ignorar intencionalmente os inserts seguros do dispositivo.
DisplayOrder
Essa propriedade controla a ordem do índice Z em que vários contêineres ScreenGui são desenhados.Aqueles com um valor mais alto DisplayOrder serão desenhados em cima daqueles com um valor mais baixo.
IgnoreGuiInset
Se esta propriedade for false (padrão), ScreenInsets é definida como CoreUISafeInsets , mantendo efetivamente seus limites abaixo da interface de usuário principal do núcleo da barra superior do Roblox.
Se esta propriedade for alterada para true e ScreenInsets estiver atualmente definida como CoreUISafeInsets , ScreenInsets será definida como DeviceSafeInsets .
Veja ScreenInsets para detalhes sobre como inserções de tela afetam o conteúdo de um ScreenGui .
SafeAreaCompatibility
Essa propriedade especifica se transformações de compatibilidade de UI automática são aplicadas ao descendente "tela cheia" GuiObjects do ScreenGui em displays com cortes de tela.A elegibilidade ocorre se a área total do descrente GuiObject (incluindo qualquer fronteira aplicada ou UIStroke ) cobrir a área segura do dispositivo tanto horizontalmente quanto verticalmente.Veja a referência de enumeração Enum.SafeAreaCompatibility para detalhes.
O valor padrão é FullscreenExtension para melhorar automaticamente a aparência da interface que foi autorizada para telas sem quaisquer cortes.No entanto, é recomendado que você evite extensões de tela cheia para novo trabalho; em vez disso, use a propriedade ScreenInsets para especificar quais inserções devem ser respeitadas para diferentes ScreenGui contêineres.
Observe que objetos de interface descendente continuarão a ser cortados pela área segura do dispositivo se ClipToDeviceSafeArea for definido como true .
ScreenInsets
Essa propriedade controla as inserções de área segura que são aplicadas ao conteúdo do ScreenGui.
O padrão de CoreUISafeInsets mantém todos os descendentes GuiObjects dentro da área segura da interface do usuário principal, limpa dos botões da barra superior do Roblox e outros cortes de tela, como o notch da câmera do dispositivo.
Se você definir essa propriedade para None, objetos de interface de usuário podem ser obscurecidos por trás de objetos de interface de usuário principais ou recortes de dispositivo, como o notch da câmera.Como resultado, você deve usar apenas None para um ScreenGui que contém conteúdo não interativo, como imagens de fundo.
Veja Contêineres de UI na tela para exemplos alternativos.