UIElement.ManipulationMode Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 .ManipulationMode
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 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
, Rotate
e Scale
ou 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.