Modificadores e restrições de tamanho

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Juntamente com o tamanho básico dos objetos de UI, você pode utilizar modificadores de tamanho para escala um objeto proporcionalmente ou redimensioná-lo automaticamente. Você também pode inserir restrições de tamanho para controlar proporção de aspecto, ou definir um tamanho mínimo e máximo de tamanho ou tamanho do texto.

Escala

Um objeto UIScale armazena um valor numérico que multiplica a propriedade AbsoluteSize do GuiObject pai. Por exemplo, se você quiser que um objeto seja duas vezes maior do que atualmente é, pode inserir um objeto UIScale com uma propriedade Scale de 2.

Esse modificador é útil para "aproximar" enquanto projeta uma interface de usuário detalhada no Studio, uma vez que escala proporcionalmente o objeto e todos os seus filhos, incluindo qualquer modificador de aparência aplicado, como UIStroke ou UICorner. Também é útil para tween o tamanho de um objeto, por exemplo, para aumentar ligeiramente o tamanho de um botão quando um jogador passa o mouse sobre ele.

Redimensionamento automático

A propriedade AutomaticSize redimensiona automaticamente um GuiObject pai para o tamanho de seus descendentes. Você pode usar essa propriedade em uma variedade de casos, incluindo:

  • Expandindo um GuiObject para caber texto que foi localizado em muitas linguagens.
  • Permitindo que os usuários insiram texto em um TextBox, ajustando automaticamente seu tamanho com base na quantidade de texto inserido.
  • Ajustando automaticamente o tamanho de objetos de texto usando marcação de texto rico, incluindo tipo de fonte e tamanho.

Você pode habilitar a propriedade AutomaticSize para qualquer GuiObject. Por padrão, ela é definida como None, mas você pode alterar seu valor para ter controle específico sobre qual(is) direção(ões) o GuiObject redimensiona para se ajustar ao seu conteúdo.

Para habilitar o redimensionamento automático:

  1. Na janela Explorer, clique em qualquer GuiObject, como um Frame, TextBox ou ImageLabel.

  2. Na janela Properties, navegue até a propriedade AutomaticSize (AutomaticCanvasSize para ScrollingFrame) e defina-a como uma das seguintes opções:

    • X — Redimensiona o conteúdo horizontalmente.
    • Y — Redimensiona o conteúdo verticalmente.
    • XY — Redimensiona o conteúdo tanto horizontal quanto verticalmente.

Uma vez configurado o redimensionamento automático, observe que outras propriedades do objeto se comportam da seguinte forma:

Semelhante ao conceito de tamanho de um objeto, AutomaticSize leva em consideração a propriedade AnchorPoint ao redimensionar o conteúdo. Por exemplo, o seguinte vídeo exibe três TextLabels que redimensionam automaticamente de seu ponto de âncora.

Restrições

Existem três tipos de restrições que você pode usar para um objeto de interface de usuário: tamanho, tamanho do texto e proporção de aspecto. Para usar uma restrição, você deve configurá-la como um filho do GuiObject que deseja restringir.

Tamanho

A UISizeConstraint especifica um tamanho mínimo e máximo para um GuiObject. Essa restrição garante que o GuiObject não fique muito pequeno ou muito grande em diferentes tamanhos de tela.

Por exemplo, se você definir a propriedade MinSize para (200, 200) e a propriedade MaxSize para (400, 400), o GuiObject não pode escalar menor que 200×200 pixels ou maior que 400×400 pixels.

Tamanho do texto

A UITextSizeConstraint especifica um tamanho de fonte mínimo e máximo para um GuiObject com texto, como um TextLabel, TextButton ou TextBox. Essa restrição garante que o texto dentro de um GuiObject não se torne ilegível ou muito grande.

Se você habilitar a propriedade TextScaled do GuiObject pai, o tamanho do texto escala com o tamanho do contêiner e respeita as restrições, mesmo se o objeto se tornar menor ou maior que os valores de MinTextSize e MaxTextSize.

Por exemplo, o seguinte objeto TextLabel tem uma UITextSizeConstraint com um valor de MinTextSize de 50 e um valor MaxTextSize de 80. Mesmo quando o TextLabel se torna menor, a fonte nunca fica menor que 50 pixels, e quando o objeto se torna grande, a fonte nunca excede 80 pixels.

Proporção de aspecto

A UIAspectRatioConstraint impõe uma proporção de largura-altura em um GuiObject, independentemente de seu tamanho base, mesmo se esse tamanho for definido como uma porcentagem de seu pai. Por exemplo, inserir essa restrição como um filho de um Frame e definir a propriedade AspectRatio da restrição para 2 (2:1) mantém a largura do quadro duas vezes maior que sua altura. Da mesma forma, definir a propriedade AspectRatio desta restrição para 0.5 (0.5:1) mantém a largura do quadro na metade de sua altura.

Definir a propriedade AspectRatio desta restrição para o padrão de 1 (1:1) é uma maneira conveniente de evitar escalonamentos/distorções desproporcionais de um ImageLabel com um ativo de imagem quadrada, como uma miniatura de avatar.

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.