VisualInteractionSource.IsPositionYRailsEnabled 속성

정의

네임스페이스:

Microsoft.UI.Composition.Interactions

y축의 이동이 레일링되는지 여부를 나타냅니다.

IsPositionYRailsEnabled 속성은 Y축 이동이 해당 InteractionTracker로 전송되는 경우에 대한 난간 구성을 정의합니다. 사용하도록 설정하면 팬의 초기 부분이 Y축을 기준으로 특정 범위 내에서 기울어지면 팬의 X 구성 요소가 무시되고 완벽한 세로 팬으로 간주됩니다. 이 속성은 X 및 Y 스크롤 환경을 모두 사용할 수 있지만 안정적이고 완벽한 수직 이동이 필요한 경우에 사용하도록 설정되는 경우가 많습니다.

public:
 property bool IsPositionYRailsEnabled { bool get(); void set(bool value); };

bool IsPositionYRailsEnabled();

void IsPositionYRailsEnabled(bool value);

public bool IsPositionYRailsEnabled { get; set; }

var boolean = visualInteractionSource.isPositionYRailsEnabled;
visualInteractionSource.isPositionYRailsEnabled = boolean;

Public Property IsPositionYRailsEnabled As Boolean

속성 값

Boolean

bool

y축의 이동이 레일링되는지 여부를 나타내는 부울 값입니다.

예제

void SetupInteractionSource(ContainerVisual container, InteractionTracker 	tracker)
{
  // Setup the InteractionSource
  _interactionSource = VisualInteractionSource.Create(container);
  // Enable the property for rails on the Y axis being enabled
  _interactionSource.IsPositionYRailsEnabled = true;
  // Add the InteractionSource to the InteractionTracker
  tracker.InteractionSources.Add(_interactionSource);
}

설명

이 속성을 사용하도록 설정하면 시스템은 "완벽한" 세로 팬으로 간주되는 항목에 더 많은 관용을 제공합니다. 종종 손가락이 화면을 가로질러 이동하면 최종 사용자가 Y 방향에서 완벽한 팬을 달성하기가 매우 어렵습니다. 이 속성을 사용하면 X 및 Y 이동이 이미 활성화된 시나리오(예: 다방향 스크롤)에서 "완벽한" 세로 이동이 가능해집니다.

사용하도록 설정하면 세로 축에서 22.5도 이내의 이동은 "완벽한" 세로 이동으로 인식됩니다. 즉, X 구성 요소는 무시됩니다. 팬의 각도는 상호 작용의 처음 몇 밀리미터 내에서 결정되며 손가락이 들어올릴 때까지 해당 각도를 유지합니다. 축의 임계값을 22.5도 벗어나면 X 구성 요소가 인식됩니다.

아래 다이어그램은 시각적 형식으로 표시됩니다.

참고

레일을 사용하도록 설정하면 연결에 영향을 줍니다. 팬이 축의 22.5도 내에 있는 경우 시스템은 가장 가까운 acenstor VisualInteractionSource에만 연결됩니다.