UIElement.ManipulationMode Propriedade

Definição

Namespace:

Microsoft.UI.Xaml

Obtém ou define o valor ManipulationModes usado para o comportamento de UIElement e a interação com gestos. Definir esse valor permite lidar com os eventos de manipulação desse elemento no código do aplicativo.

public:
 property ManipulationModes ManipulationMode { ManipulationModes get(); void set(ManipulationModes value); };

ManipulationModes ManipulationMode();

void ManipulationMode(ManipulationModes value);

public ManipulationModes ManipulationMode { get; set; }

var manipulationModes = uIElement.manipulationMode;
uIElement.manipulationMode = manipulationModes;

Public Property ManipulationMode As ManipulationModes

<uiElement ManipulationMode="All"/>
-or-
<uiElement ManipulationMode="None"/>
-or-
<uiElement ManipulationMode="singleManipulationModesMemberName"/>
-or-
<uiElement ManipulationMode="relatedManipulationModesNames"/>

Valor da propriedade

ManipulationModes

Um valor ou valores da enumeração. O padrão normalmente é Sistema, mas isso pode variar em controles e elementos específicos. Consulte Observações.

Comentários

Você deve definir o ManipulationMode como um valor diferente System de ou None se quiser lidar com eventos de manipulação, como ManipulationStarted de elementos de interface do usuário no código do aplicativo. Para obter mais informações sobre manipulações, consulte Entrada de ponteiro de identificador.

O valor padrão típico de é System em vez de .ManipulationModeNone Quando o valor é System, as manipulações originadas do elemento podem ser manipuladas pela infraestrutura de Windows Runtime, que é baseada na API de Manipulação Direta. Por exemplo, ScrollViewer manipula manipulações de usuário em sua lógica de controle e as processa como ações de rolagem para o controle. O System valor também permite animações de personalidade que respondem a eventos de manipulação.

Slider e ToggleSwitch têm modelos padrão que definem o valor ManipulationMode como None, portanto None , será o valor padrão que você vê no momento do design.

Especificando modos de manipulação relacionados

Você pode especificar mais de um dos valores de ManipulationModes flagwise como o valor da ManipulationMode propriedade . Isso é possível no XAML usando a sintaxe de vírgula mostrada na seção "Valores XAML". Por exemplo, você pode combinar TranslateX, TranslateY, Rotatee Scaleou qualquer combinação desses. No entanto, nem todas as combinações são válidas. A validade é imposta apenas uma vez ManipulationModes que é usada por um controle específico, portanto, os problemas com a configuração de uma combinação inválida de ManipulationModes podem não aparecer até o tempo de execução, quando os valores são aplicados.

• Não combine valores Translate* com valores TranslateRails*, eles são tratados como valores mutuamente exclusivos.
• Não combine os valores inerciais com os valores não inerciais.
• O valor All não é o valor aditivo verdadeiro de todos os sinalizadores (se os valores forem comparados bit a bit). Um valor all não indica necessariamente que a combinação de todos os valores é válida ou que qualquer valor específico é definido.

Confira também

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• Identificar entrada do ponteiro
• Referência de manipulação direta
• Exemplo de entrada básico (Windows 10)