HandleAdornment
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Resumo
Propriedades
Determina se deve eliminar automaticamente o adorno.
Força esse objeto a renderizar em cima de todos os objetos 3D no espaço de trabalho.
A posição e a rotação do objeto em relação a seu PVAdornment.Adornee .
O deslocamento posicional do adorno com base no adornado de BasePart.Size.
Determina a ordem de desenho do HandleAdornment .
O PVInstance que o PVAdornment está anexado a.
Define a cor de um ObjetoGUI.
Define a transparência de um ObjetoGUI, onde 1 é invisível e 0 é completamente visível.
Determina se o objeto e seus descendentes serão exibidos.
Eventos
Dispara quando um usuário pressiona o botão esquerdo do mouse enquanto paira sobre o adorno.
Dispara quando um usuário solta o botão esquerdo do mouse enquanto paira sobre o adorno.
Dispara quando um usuário move o mouse sobre o adorno.
Dispara quando um usuário move o mouse para fora da decoração.
Propriedades
AdornCullingMode
AlwaysOnTop
Força esse objeto a renderizar em cima de todos os objetos 3D no espaço de trabalho.Mesmo que o adorno esteja atrás de uma parte com base em seu HandleAdornment.CFrame, se AlwaysOnTop for verdadeiro, o adorno ainda será desenhado no topo.A única exceção a esse comportamento é se o HandleAdornment.ZIndex do adorno for definido como -1.Se esse for o caso, o adorno sempre se desenhará atrás da geometria 3D.
CFrame
A posição e a rotação em relação ao seu PVAdornment.Adornee .Este CFrame está no espaço local do adornado, então forward (0,0,-1) será forward em relação ao adornado.O deslocamento e a rotação deste CFrame são aplicados após quaisquer traduções devido a HandleAdornment.SizeRelativeOffset.
SizeRelativeOffset
O deslocamento posicional do adorno com base no adornado de BasePart.Size.Por padrão, um adornoamento é desenhado no centro de seu adornado.Ao usar essa propriedade, a posição do adorno pode ser movida em relação ao centro do adornado.As unidades de Offset de Tamanho Relativo são uma escala baseada no tamanho do adornado em si.Essa escala é tal que um valor de 1 moverá o adorno para a borda correspondente do adornado.Essa propriedade tem a intenção de permitir que adornos sejam facilmente movidos para as bordas de peças.
Por exemplo, se o OffsetRelativo de Tamanho for definido como (0,1,0), o adorno será desenhado com seu centro na parte superior exata do adornado.Se definido como (1,1,1), o adorno será desenhado no canto superior do adornado.
ZIndex
A propriedade ZIndex determina a ordem de desenho do HandleAdornment.Isso se refere apenas a como o adorno se desenhará em relação a outros adornos ou objetos 3D no espaço de trabalho.Isso não se relaciona com o GuiObject.ZIndex de GuiObjects.
Os valores válidos para ZIndex são de -1 a 10.Se dois HandleAdornments forem desenhados sobre um ao outro, o que tiver o ZIndex mais alto será desenhado.Esta ordem de desenho será respeitada mesmo se o adorno com ZIndex mais alto estiver atrás do outro adorno em termos de sua posição no espaço 3D.Se definido como -1, o ZIndex forçará o adorno a desenhar atrás de outros adornos e objetos no Workspace, mesmo que a propriedade HandleAdornment.AlwaysOnTop para o adorno seja verdadeira.
Métodos
Eventos
MouseButton1Down
Dispara quando um usuário pressiona o botão esquerdo do mouse enquanto paira sobre o adorno.
MouseButton1Up
Dispara quando um usuário solta o botão esquerdo do mouse enquanto paira sobre o adorno.
MouseEnter
Dispara quando um usuário move o mouse sobre o adorno.
MouseLeave
Dispara quando um usuário move o mouse para fora da decoração.