ImageLabel
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Um ImageLabel renderiza um retângulo, como um Frame faz, com um ativode imagem.O exibição da imagem pode ser manipulada através das propriedades ImageColor3 e ImageTransparency.Para exibir apenas a imagem e ocultar o retângulo, defina GuiObject.BackgroundTransparency para 1.
O uso avançado ImageLabel inclui:
Imagens em azulejos podem ser criadas definindo ScaleType para Enum.ScaleType.Tile , então TileSize para o tamanho dos azulejos renderizados.
imagens de 9 fatias podem ser criadas definindo ScaleType para Enum.ScaleType.Slice , então SliceCenter para a área central da imagem de 9 fatias.
Folhas de sprite podem ser implementadas através do uso de ImageRectOffset e ImageRectSize .Embalar várias imagens em uma e usar essa propriedade pode fazer com que os recursos de imagem de sua experiência carreguem muito mais rapidamente, especialmente se você usar muitas pequenas ícones em suas interfaces de usuário.
Resumo
Propriedades
O conteúdo de imagem exibido pelo elemento da interface de usuário. Lê e escreve em ImageContent .
Determina como uma imagem renderizada será colorizada.
O conteúdo de imagem exibido pelo elemento da interface do usuário. Suporta URI de recurso e EditableImage.
O deslocamento em pixels da subárea de uma imagem a ser exibida.
Determina o tamanho em pixels da subárea de uma imagem a ser exibida.
Determina a transparência da imagem renderizada.
Indica se a imagem terminou de carregar do Roblox.
Seleciona o modo de resampling de imagem para a etiqueta / rótulo.
Determina como uma imagem será escalada se exibida em um elemento de UI cujo tamanho difere da imagem de origem.
Define os limites de uma fatia de uma imagem de 9 fatias.
Escala as bordas de 9 fatias pela taxa especificada.
Define o tamanho do mosaico do ImageLabel .
Determina se este elemento de UI afunda a entrada.
Determina o ponto de origem de um GuiObject , em relação ao seu tamanho absoluto.
Determina se o redimensionamento ocorre com base no conteúdo da criança.
Determina a cor de fundo GuiObject .
Determina a transparência do plano de fundo e da borda GuiObject.
Determina a cor da borda GuiObject .
Determina de que maneira a borda GuiObject é disposta em relação às suas dimensões.
Determina a largura do pixel da borda GuiObject .
Determina se descendente GuiObjects fora dos limites de um elemento GUI pai deve renderizar.
Determina se o mouse do jogador está sendo pressionado ativamente no GuiObject ou não.
Determina se o GuiButton pode ser interagido ou não, ou se o GuiState do GuiObject está mudando ou não.
Controla a ordem de classificação do GuiObject quando usado com um UIGridStyleLayout .
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para baixo.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para a esquerda.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para a direita.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para cima.
Determina a posição do pixel e escalar da GuiObject .
Determina o número de graus em que o GuiObject é girado.
Determine se o GuiObject pode ser selecionado por um controle / controle de jogo.
Substitui o adorno de seleção padrão usado para gamepads.
A ordem de GuiObjects selecionada pela seleção da interface do gamepad.
Determina o tamanho do pixel e escalar do GuiObject .
Define os eixos Size que o GuiObject será baseado, em relação ao tamanho de seu pai.
Uma propriedade mista de BackgroundTransparency e TextTransparency.
Determina se o GuiObject e seus descendentes serão renderizados.
Determina a ordem em que um GuiObject renderiza em relação aos outros.
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.
Métodos
Métodos herdados de GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Mova suavemente uma GUI para um novo UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Mova suavemente uma GUI para um novo tamanho e posição.
Eventos
Eventos herdados de GuiObjectDispedido quando um usuário começa a interagir através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começa, botão do teclado para baixo, etc).
Dispedido quando um usuário muda como está interagindo através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começa, botão da tecla para baixo, etc).
Dispedido quando um usuário para de interagir através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começar, botão da tecla para baixo, etc).
Dispara quando um usuário move o mouse para um elemento de GUI.
Dispara quando um usuário move o mouse para fora de um elemento de GUI.
Incêndios sempre que um usuário move o mouse enquanto ele está dentro de um elemento de GUI.
Dispara quando um usuário rola a roda do mouse de volta quando o mouse está sobre um elemento de GUI.
Dispara quando um usuário rola a roda do mouse para a frente quando o mouse está sobre um elemento de GUI.
Disparado quando o GuiObject está sendo focado no seletor Gamepad.
Dispedido quando o seletor de Gamepad para de se concentrar no GuiObject.
Incêndios quando o jogador começa, continua e para de apertar a tecla da interface de usuário por muito tempo.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Dispara quando o jogador move o dedo sobre o elemento da interface.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Incêndios quando o jogador executa um gesto de pinça ou puxão usando dois dedos no elemento da interface.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Incêndios quando o jogador executa um gesto de rotação usando dois dedos no elemento da interface.
Incêndios quando o jogador executa um gesto de deslize no elemento da interface.
Dispara quando o jogador executa um gesto de toque no elemento da interface.
- 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
Image
Esta propriedade é uma propriedade do tipo conteúdo que deve conter o ID do recurso de um decal ou imagem carregado no Roblox.Ela funciona de forma idêntica a Decal.Texture com relação ao carregamento da imagem do Roblox.A imagem renderizada pode ser modificada usando ImageColor3 e ImageTransparency.
ImageColor3
Essa propriedade determina como uma imagem é colorizada.Quando definido para branco, nenhuma colorização ocorre.Essa propriedade é muito útil para reutilizar recursos de imagem; se a imagem de origem for completamente branca com transparência, você pode definir toda a cor da imagem de uma vez com essa propriedade.
ImageContent
Essa propriedade deve conter um URI de recurso ou uma referência a um ObjetoEditableImage.
O URI de recurso pode referenciar um decalque ou imagem carregada no Roblox. Funciona de forma idêntica a Decal.Texture em relação ao carregamento da imagem.
A imagem renderizada será colorizada usando ImageButton.ImageColor3 .É possível fazer com que a imagem seja renderizada como azulejada, escalonada para caber ou 9-dividida, ajustando a propriedade ImageButton.ScaleType.
ImageRectOffset
Permite a exibição parcial de uma imagem em conjunto com ImageRectSize .Essa propriedade determina o deslocamento de pixels (a partir da esquerda superior) da área de imagem a ser exibida.
ImageRectSize
Permite a exibição parcial de uma imagem em conjunto com ImageRectOffset .Essa propriedade determina o tamanho do pixel da área de imagem a ser exibida.Se alguma dimensão for definida como 0, a imagem inteira será exibida em vez disso.
ImageTransparency
Essa propriedade determina o alfa da imagem renderizada de um elemento de UI.Um valor de 0 é completamente opaco e um valor de 1 é completamente transparente (invisível).
Amostras de código
This code sample oscillates the ImageTransparency of an ImageLabel/ImageButton from 0 to 1 using a sine wave.
local RunService = game:GetService("RunService")
local imageLabel = script.Parent
local function onRenderStep()
-- Oscillate ImageTransparency from 0 to 1 using a sine wave
imageLabel.ImageTransparency = math.sin(workspace.DistributedGameTime * math.pi) * 0.5 + 0.5
end
RunService.RenderStepped:Connect(onRenderStep)
IsLoaded
Essa propriedade indica se a propriedade ImageLabel.Image terminou de carregar do Roblox. Imagens rejeitadas pela moderação nunca serão carregadas.
Amostras de código
This code sample measures how long an ImageLabel or ImageButton takes to load an image. If the image was already loaded, this will be 0.
local imageLabel = script.Parent
local startTime = workspace.DistributedGameTime
-- Wait for the image to load
while not imageLabel.IsLoaded do
task.wait()
end
-- Measure and display how long it took to load
local deltaTime = workspace.DistributedGameTime - startTime
print(("Image loaded in %.3f seconds"):format(deltaTime))
ResampleMode
Determina como a imagem aparece quando é escalada.Por padrão, a imagem suaviza a textura ao ser exibida na tela maior ou menor do que seu tamanho na memória de textura.Quando definido para Enum.ResamplerMode.Pixelated, a imagem preserva as bordas afiadas dos pixels.
ScaleType
Essa propriedade determina de que maneira um ImageLabel.Image é renderizado quando o tamanho absoluto do elemento da interface difere do tamanho da imagem de origem.
Por padrão, esta propriedade é Enum.ScaleType.Stretch a qual simplesmente estenderá/compactará as dimensões da imagem para que ela se encaixe exatamente no espaço do elemento da interface.Como pixels transparentes são definidos como pretos ao fazer o upload para o Roblox, imagens transparentes devem aplicar fusão alfa para evitar um contorno negro em torno de imagens escalonadas.
Para Enum.ScaleType.Slice , a propriedade SliceCenter será revelada na janela Propriedades.Isto é para a interface de usuário de nove fatias: ao aumentar o tamanho, os cantos permanecerão como o tamanho da imagem de origem.Os cantos da imagem se estenderão para a largura/altura da imagem.Finalmente, o centro da imagem se estenderá para preencher a área central da imagem.
Finalmente, para Enum.ScaleType.Tile , a propriedade TileSize será revelada na janela Propriedades.Isto é para imagens com ladrilho, onde o tamanho de cada ladrilho de imagem é determinado pela propriedade TileSize.
SliceCenter
Essa propriedade define os limites de corte de uma imagem de 9 fatias quando é definido como .Observe que essa propriedade só é visível na janela Propriedades sob essa condição.
Para aprender mais sobre imagens de 9 fatias, veja Design da Interface de Usuário de 9 Fatias.
SliceScale
Escala as bordas de 9 fatias pela taxa especificada.Isso significa que as bordas ao redor da 9-slice crescerão como se você tivesse carregado uma nova versão da textura upscaled.Padrão para 1.0 .
Veja também ScaleType , SliceCenter e SliceScale .
TileSize
Essa propriedade define o tamanho do mosaico do ImageLabel com um padrão de
Amostras de código
This code sample demonstrates the different ScaleType options - Stretch, Tile and Slice. It does this by resizing an ImageLabel/ImageButton in a circle.
local imageLabel = script.Parent
-- Set the source image to be a 64x64 padlock
imageLabel.Image = "rbxassetid://284402752"
imageLabel.BackgroundTransparency = 0
imageLabel.BackgroundColor3 = Color3.new(1, 1, 1) -- White
imageLabel.ImageColor3 = Color3.new(0, 0, 0) -- Black
local function resizeInACircle()
for theta = 0, 2, 0.02 do
imageLabel.Size =
UDim2.new(0, 100 + math.cos(theta * 2 * math.pi) * 50, 0, 100 + math.sin(theta * 2 * math.pi) * 50)
task.wait()
end
end
while true do
-- Stretch simply stretches the source image to fit
-- the UI element's space
imageLabel.ScaleType = Enum.ScaleType.Stretch
resizeInACircle()
-- Tile will render the source image multiple times
-- enough to fill the UI element's space
imageLabel.ScaleType = Enum.ScaleType.Tile
imageLabel.TileSize = UDim2.new(0, 64, 0, 64)
resizeInACircle()
-- Slice will turn the image into a nine-slice UI.
imageLabel.ScaleType = Enum.ScaleType.Slice
imageLabel.SliceCenter = Rect.new(30, 30, 34, 34)
resizeInACircle()
end