UIElement.ManipulationMode Propriedade

Definição

Namespace:

Microsoft.UI.Xaml

Obtém ou define o valor ManipulationModes usado para comportamento de UIElement e 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 é System, mas isso pode variar em controles e elementos específicos. Consulte Comentários.

Comentários

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

O valor padrão típico é System em vez Nonede ManipulationMode . Quando o valor éSystem, as manipulações originadas do elemento podem ser tratadas pela infraestrutura de Windows Runtime, que se baseia na API de Manipulação Direta. Por exemplo, ScrollViewer manipula as manipulações do 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 NoneManipulationMode como, portanto None , será o valor padrão que você vê no tempo de 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 em XAML usando a sintaxe de vírgula mostrada na seção "Valores XAML". Por exemplo, você pode combinar TranslateX, TranslateY, Rotatee Scale, ou qualquer combinação deles. No entanto, nem todas as combinações são válidas. A validade é imposta apenas uma vez ManipulationModes é usada por um controle específico, portanto, os problemas com a configuração de uma combinação inválida podem ManipulationModes não aparecer até o tempo de execução em que 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 está definido.

Confira também

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