Window.SetTitleBar(UIElement) 메서드

정의

네임스페이스:

Windows.UI.Xaml

XAML 요소가 제목 표시줄인 것처럼 시스템과 상호 작용하게 합니다.

public:
 virtual void SetTitleBar(UIElement ^ value) = SetTitleBar;

void SetTitleBar(UIElement const& value);

public void SetTitleBar(UIElement value);

function setTitleBar(value)

Public Sub SetTitleBar (value As UIElement)

매개 변수

value

UIElement

제목 표시줄 역할을 해야 하는 사용자 지정 XAML 콘텐츠입니다. 여러 개체를 사용하려면 Panel에서 파생된 개체와 같은 컨테이너 요소에 래핑 합니다.

설명

이 메서드를 사용하면 앱 창의 제목 표시줄처럼 시스템과 상호 작용하는 XAML 요소를 지정할 수 있습니다. 이 메서드를 사용하는 경우 일반적으로 CoreApplicationViewTitleBar.ExtendViewIntoTitleBar 속성을 true 로 설정하여 기본 시스템 제목 표시줄을 숨깁니다. 그러나 기본 시스템 제목 표시줄이 숨겨지지 않은 경우에도 앱의 추가 지역이 제목 표시줄처럼 동작하도록 하는 데 사용할 수 있습니다.

다음과 같이 CoreApplicationView.TitleBar 속성을 사용하여 앱 창에 대한 CoreApplicationViewTitleBar의 instance 가져옵니다.

// Requires using Windows.ApplicationModel.Core
CoreApplicationView coreView = CoreApplication.GetCurrentView();
CoreApplicationViewTitleBar coreTitleBar = coreView.TitleBar;
coreTitleBar.ExtendViewIntoTitleBar = true;

// -- OR --

CoreApplication.GetCurrentView().TitleBar.ExtendViewIntoTitleBar = true;

참고

앱은 항상 모바일 디바이스에서 전체 화면이고 창 제목 표시줄이 없으므로 모바일 디바이스에서 앱을 실행할 때 이 메서드는 영향을 주지 않습니다.

입력

이 메서드를 호출하여 XAML UIElement 를 제목 표시줄로 설정하면 Windows에서 기본 시스템 제목 표시줄에 대한 입력을 처리하는 것과 동일한 방식으로 제목 표시줄 UIElement 에 대한 입력을 처리할 수 있습니다. 예를 들어 사용자는 XAML UIElement를 끌어 창을 이동하거나 마우스 오른쪽 단추로 클릭하여 창 상황에 맞는 메뉴를 호출할 수 있습니다.

즉, 사용자가 터치, 마우스 또는 펜을 사용하여 대상 UIElement 또는 해당 자식과 상호 작용할 때 앱이 더 이상 포인터 입력을 받지 않습니다. 그러나 키보드 입력을 처리(또는 방지)하고, 키보드로 탭하여 제목 표시줄의 콘텐츠가 포커스를 받을 수 있는지 여부를 결정해야 합니다.

레이아웃 및 모양

표시 유형 및 크기와 같은 제목 표시줄 변경에 대한 응답으로 대상 UIElement 의 시각적 콘텐츠 및 레이아웃을 업데이트해야 합니다.

시스템 제목 표시줄의 표시 유형과 일치하려면 CoreApplicationViewTitleBar.IsVisibleChanged 이벤트를 처리하고 사용자 지정 제목 표시줄을 적절하게 표시하고 숨겨 CoreApplicationViewTitleBar.IsVisible 속성을 준수합니다. 이렇게 하면 시스템 제목 표시줄이 숨겨져 있을 때 사용자 지정 제목 표시줄 콘텐츠가 올바르게 숨겨집니다. 예를 들어 사용자가 앱을 전체 화면 모드로 표시하도록 선택하는 경우입니다.

제목 표시줄이 항상 존재하는 시스템 최소화, 최대화 및 닫기 단추와 같은 다른 제목 표시줄 요소의 크기와 일치하도록 하려면 CoreApplicationViewTitleBar.LayoutMetricsChanged 이벤트를 처리하고 CoreApplicationViewTitleBar.Height, SystemOverlayLeftInset 및 SystemOverlayRightInset 속성을 준수합니다.

최소화, 최대화 및 닫기와 같은 기본 제목 표시줄 단추는 항상 시스템에 표시되므로 사용자 지정 XAML 제목 표시줄 콘텐츠와 일치하도록 색을 수정할 수도 있습니다. 이렇게 하려면 Windows.UI.ViewManagement.ApplicationView.TitleBar 속성을 사용하여 앱 창에 대한 ApplicationViewTitleBar의 instance 가져옵니다. 그런 다음 ApplicationViewTitleBar 에서 다양한 색 속성을 설정하여 기본 단추를 수정할 수 있습니다.