UIElement.ManipulationMode 속성

정의

UIElement 동작 및 제스처와의 상호 작용에 사용되는 ManipulationModes 값을 가져오거나 설정합니다. 이 값을 설정하면 앱 코드에서 이 요소의 조작 이벤트를 처리할 수 있습니다.

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"/>

속성 값

열거형의 값 또는 값입니다. 기본값은 일반적으로 시스템이지만 특정 컨트롤 및 요소에 따라 달라질 수 있습니다. 설명 부분을 참조하세요.

설명

를 이외의 SystemNone 값으로 설정하거나 앱 코드의 UI 요소에서 ManipulationStarted와 같은 조작 이벤트를 처리하려는 경우 를 설정 ManipulationMode 해야 합니다. 조작에 대한 자세한 내용은 포인터 입력 처리를 참조하세요.

ManipulationMode 일반적인 기본값은 가 아닌 None입니다System. 값이 인 경우 System요소에서 시작된 조작은 직접 조작 API를 기반으로 하는 Windows 런타임 인프라에서 처리할 수 있습니다. 예를 들어 ScrollViewer 는 컨트롤 논리에서 사용자 조작을 처리하고 컨트롤에 대한 스크롤 작업으로 처리합니다. 또한 이 System 값을 사용하면 조작 이벤트에 응답하는 성격 애니메이션을 사용할 수 있습니다.

SliderToggleSwitch 에는 ManipulationMode 값을 None로 설정하는 기본 템플릿이 있으므로 None 디자인 타임에 표시되는 기본값이 됩니다.

플래그가 지정된 ManipulationModes 값 중 둘 이상을 속성 값 ManipulationMode 으로 지정할 수 있습니다. 이는 "XAML 값" 섹션에 표시된 쉼표 구문을 사용하여 XAML에서 가능합니다. 예를 들어 , , TranslateYRotateScale또는 이러한 조합을 결합TranslateX할 수 있습니다. 그러나 모든 조합이 유효한 것은 아닙니다. 유효성은 특정 컨트롤에서 한 번만 ManipulationModes 적용되므로 값이 적용되는 런타임까지 잘못된 조합 ManipulationModes 설정 관련 문제가 나타나지 않을 수 있습니다.

  • Translate* 값을 TranslateRails* 값과 결합하지 마세요. 이러한 값은 상호 배타적인 값으로 처리됩니다.
  • 비관성 값과 관성 값을 결합하지 마세요.
  • All 값은 모든 플래그의 실제 가산 값이 아닙니다(값이 비트로 비교되는 경우). 모두 값이 반드시 모든 값의 조합이 유효하거나 특정 값이 설정되었음을 나타내는 것은 아닙니다.

적용 대상

추가 정보