UIElement.ManipulationMode 속성

정의

네임스페이스:

Windows.UI.Xaml

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

속성 값

ManipulationModes

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

설명

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

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

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

관련 조작 모드 지정

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

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

이전 버전에 대한 참고 사항

Windows 8.x Windows 8 OperationMode를 System을 다른 값과 결합하는 값으로 설정하면 예외가 발생하므로 위에서 언급한 조합 중 일부는 Windows 8 작동하지 않습니다. Windows 8.1 시작하여 System을 다른 값과 결합할 수 있습니다.

Windows 8 위해 컴파일되었지만 Windows 8.1 실행되는 앱은 새 동작을 사용하고 System을 다른 값과 결합하는 것을 허용합니다.

추가 정보

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• 포인터 입력 처리
• 직접 조작 참조
• 기본 입력 샘플(Windows 10)