UIDragDetector

Define o ícone do cursor para exibir quando o mouse é ativado sobre o pai deste UIDragDetector .Se esta propriedade for deixada em branco, o detector usará o ícone padrão.

Para alterar o ícone do cursor ativado, defina esta propriedade para o ID do recurso da imagem que você gostaria de usar.

Determina o comportamento de borda do objeto UI arrastado quando o BoundingUI do detector é definido. Veja Enum.UIDragDetectorBoundingBehavior para detalhes sobre o comportamento de cada configuração.

Quando definido, a instância UIDragDetector não permitirá que os limites do pai GuiObject sejam arrastados fora dos limites da instância BoundingUI .

Observe que, se uma parte do pai GuiObject estiver fora dos limites da BoundingUI , a posição inicial de entrada ao arrastar e sua posição relativa durante o arrastamento serão usadas para detecção de limites até que toda a entidade arrastada esteja dentro dos limites, após o qual o objeto será limitado dentro dos limites.

Define o ícone do cursor para exibir quando o mouse está sobre o pai deste UIDragDetector .Se esta propriedade for deixada em branco, o detector usará o ícone padrão.

Para alterar o ícone do cursor, defina esta propriedade para o ID do recurso da imagem que você gostaria de usar.

Vector2 valor que define o eixo de movimento para o objeto arrastado quando DragStyle é definido como Enum.UIDragDetectorDragStyle.TranslateLine.O eixo é definido no espaço local do UIDragDetector a menos que ReferenceUIInstance seja definido, no qual o eixo é definido no espaço local daquele momento.

Aplica-se somente se uma função de arrastamento personalizada for registrada através de SetDragStyleFunction() ou AddConstraintFunction().Define o paradigma que define a relatividade dos inputs/outputs da função registrada.

Por exemplo, retornar um de uma função registrada com essa propriedade definida como moverá o pai do detector para no local designado , enquanto retornar o mesmo com essa propriedade definida como moverá o pai do detector para no local designado .

A rotação realizada pelo arrastamento atual.Este valor é definido em graus em relação ao espaço local do UIDragDetector a menos que ReferenceUIInstance seja definido, no qual a rotação é definida no espaço local dessa instância e a partir de seu eixo positivo X .

Essa propriedade pode ser alterada enquanto não há traço ativo para girar o objeto arrastado.

Aplica-se somente se uma função de arrastamento personalizada for registrada através de SetDragStyleFunction() ou AddConstraintFunction().Define o paradigma que define o espaço dos inputs/outputs da função registrada.

Por exemplo, se o pai do detector GuiObject for um filho de um pai GuiObject que foi girado:

• Retornar um de uma função registrada com essa propriedade definida como moverá o pai do detector para a direita por 1 pixel no espaço local afetado pela rotação de seu pai.

• Retornar um de uma função registrada com essa propriedade definida como moverá o pai do detector para a direita por 1 pixel no espaço do .

O paradigma usado para gerar a proposta de movimento, dado um fluxo de vetores de posição de entrada. Veja Enum.UIDragDetectorDragStyle para opções.

A tradução realizada pela arrastada atual expressa em um valor UDim2 .A tradução é feita através de Offset ou Scale alterações de valor dependendo do valor DragRelativity e é relativa ao espaço local do detector, a menos que um ReferenceUIInstance seja definido.

Essa propriedade pode ser alterada enquanto não há arrasto ativo para mover o objeto arrastado.

Se true , o UIDragDetector responde à entrada do usuário; se false , não o faz.

Se esta propriedade for maior que MinDragAngle, a rotação será limitada dentro do alcance de MinDragAngle e MaxDragAngle.Os valores positivos impedem a rotação no sentido horário enquanto os valores negativos impedem a rotação no sentido antihorário.

Esta não é uma restrição; ele apenas impede as tentativas do detector de gerar movimento para permanecer dentro dos limites.Veja AddConstraintFunction() para adicionar restrição personalizada a um arraste.

Só é relevante se DragStyle for Enum.UIDragDetectorDragStyle.Rotate.

Se os valores correspondentes Offset e/ou Scale forem maiores que os de MinDragTranslation em todas as dimensões, a tradução linear/plana será limitada dentro do alcance de MinDragTranslation e MaxDragTranslation .

Esta não é uma restrição; ele apenas impede as tentativas do detector de gerar movimento para permanecer dentro dos limites.Veja AddConstraintFunction() para adicionar restrição personalizada a um arraste.

Só é relevante se DragStyle for Enum.UIDragDetectorDragStyle.TranslateLine ou Enum.UIDragDetectorDragStyle.TranslatePlane.

Se esta propriedade for menor que MaxDragAngle, a rotação será limitada dentro do alcance de MinDragAngle e MaxDragAngle.Os valores positivos impedem a rotação no sentido horário enquanto os valores negativos impedem a rotação no sentido antihorário.

Esta não é uma restrição; ele apenas impede as tentativas do detector de gerar movimento para permanecer dentro dos limites.Veja AddConstraintFunction() para adicionar restrição personalizada a um arraste.

Só é relevante se DragStyle for Enum.UIDragDetectorDragStyle.Rotate.

Se os valores correspondentes de Offset e/ou Scale forem menores que os de MaxDragTranslation em todas as dimensões, a tradução linear/plana será limitada dentro do alcance de MinDragTranslation e MaxDragTranslation .

Esta não é uma restrição; ele apenas impede as tentativas do detector de gerar movimento para permanecer dentro dos limites.Veja AddConstraintFunction() para adicionar restrição personalizada a um arraste.

Só é relevante se DragStyle for Enum.UIDragDetectorDragStyle.TranslateLine ou Enum.UIDragDetectorDragStyle.TranslatePlane.

Uma instância GuiObject que tem o espaço local e a posição do centro absoluto como o espaço de referência e a origem para o detector.Definir essa referência afeta propriedades como DragUDim2 , DragRotation e o comportamento de DragAxis.

Uma vez que a moção proposta foi computada e potencialmente restrita, este paradigma é usado para determinar como mover (ou não mover) o GuiObject afetado pelo UIDragDetector.Veja Enum.UIDragDetectorResponseStyle para opções.

Define a velocidade máxima de arrastamento para tradução como uma combinação de e da primeira ancestral ou a que pertence.Este valor deve ser positivo e qualquer valor abaixo de 0 será clampado para 0 .

Define o ângulo máximo por segundo em que o UIDragDetector pode girar.Este valor deve ser positivo e qualquer valor abaixo de 0 será clampado para 0 .

Enum.UIDragSpeedAxisMapping valor que determina as velocidades de arrastamento da dimensão X / Y .

Adiciona uma função para modificar ou restringir a movimentação proposta.A função recebe uma entrada UDim2 (posição) e flutuação (rotação) de proposta de movimento e retorna uma entrada UDim2 e flutuação de modificada ou não modificada de movimento.Você pode adicionar múltiplas funções que serão chamadas em ordem por priority, passando os resultados em uma cadeia.

A entrada é expressa no espaço definido pela propriedade DragSpace, seja como um delta ou a posição/rotação final desejada com base na propriedade DragRelativity.A saída deve ser expressa no mesmo espaço e relatividade, a menos que substituída por retornar um valor de retorno especificado Enum.UIDragDetectorDragRelativity e Enum.UIDragDetectorDragSpace como os terceiro e quarto valores de retorno.

Para remover uma função de restrição adicionada, chame Disconnect() na conexão retornada.

Parâmetros

Devolução

Quando nenhum ReferenceUIInstance é definido, esta função retorna a posição UDim2 do pai imediato do objeto arrastado GuiObject (se existir um), ou então a posição UDim2 do objeto arrastado.

Quando um ReferenceUIInstance é definido, essa função retorna a posição UDim2 daquela instância de referência.

Devolução

Quando nenhum ReferenceUIInstance é definido, essa função retorna a rotação do pai imediato do objeto arrastado GuiObject (se existir um), ou então a rotação do objeto arrastado.

Quando um ReferenceUIInstance é definido, essa função retorna a rotação daquela instância de referência.

Devolução

Passa uma função a ser usada se e somente se DragStyle for definido como Enum.UIDragDetectorDragStyle.Scriptable.A função dada recebe a posição de espaço na tela do sinal com o tipo Vector2 e retorna uma posição UDim2 (posição) e flutuação (rotação) que contém o movimento desejado do arrasto.O espaço dos valores de retorno e a relatividade do movimento são determinados pelas propriedades DragSpace e DragRelativity, a menos que sejam substituídas por retornar um valor especificado Enum.UIDragDetectorDragRelativity e Enum.UIDragDetectorDragSpace como os terceiro e quarto valores de retorno.

Se a função retornar nil, o objeto não será movido.Isso é útil se o script ainda não coletou todas as informações de que precisa para dar a resposta correta ou em casos temporários em que você quer que o objeto permaneça onde está.

Parâmetros

Devolução

Incêndios quando um usuário continua arrastando o elemento da interface de usuário depois que DragStart foi iniciado.

Parâmetros

Dispara quando um usuário para de arrastar o elemento da interface de usuário.

Parâmetros

Dispara quando um usuário começa a arrastar o elemento da interface de usuário.

Parâmetros