UIElement.ManipulationMode Propriedade

Definição

Namespace:

Windows.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 de System 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 ManipulationMode é System em vez de None. 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 valor Sistema 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 Nenhum, portanto Nenhum 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 propriedade ManipulationMode. Isso é possível no XAML usando a sintaxe de vírgula mostrada na seção "Valores XAML". Por exemplo, você pode combinar TranslateX, TranslateY, Rotate e Scale ou qualquer combinação delas. No entanto, nem todas as combinações são válidas. A validade é imposta somente quando ManipulationModes é usado por um controle específico, portanto, 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.

Anotações para versões anteriores

Windows 8.x No Windows 8, definir ManipulationMode como um valor que combina Sistema com qualquer outro valor gerará uma exceção, portanto, algumas das combinações mencionadas acima não funcionarão para Windows 8. Começando com Windows 8.1, você pode combinar Sistema com outros valores.

Os aplicativos compilados para Windows 8 mas em execução no Windows 8.1 usam o novo comportamento e permitem a combinação de Sistema com outros valores.

Confira também

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