다음을 통해 공유

PopupMenu 클래스

  • 참조

정의

네임스페이스:
Windows.UI.Popups
편집

상황에 맞는 메뉴를 나타냅니다.

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.

public ref class PopupMenu sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class PopupMenu final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PopupMenu final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class PopupMenu
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PopupMenu
function PopupMenu()
Public NotInheritable Class PopupMenu
상속
Object Platform::Object IInspectable PopupMenu
특성
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

이벤트에 대한 "contextmenu" 이벤트 수신기를 추가하여 사용자에게 상황에 맞는 메뉴를 제공합니다. 예를 들어 상황에 맞는 메뉴 샘플 은 특정 HTML 요소에서 이벤트를 수신 대기한 다음 함수를 호출합니다 scenario1AttachmentHandler .

document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);

상황에 맞는 메뉴를 사용자 지정하려면 이벤트에서 preventDefault 를 호출하여 기본값을 표시하지 않은 다음 상황에 맞는 메뉴 샘플과 같이 비어 있는 새 상황에 맞는 메뉴를 만듭니다.

e.preventDefault(); // Prevent the default context menu.

var menu = new Windows.UI.Popups.PopupMenu();

설명

상황에 맞는 메뉴는 최대 6개의 명령을 표시할 수 있습니다. 이 제한은 상황에 맞는 메뉴가 깔끔하고 사용 가능하며 사용자와 직접 관련된 상태로 유지되도록 하는 데 도움이 됩니다.

상황에 맞는 메뉴 샘플(Windows 10) 및 상황에 맞는 메뉴 샘플(Windows 8.1)에서 상황에 맞는 메뉴를 만들고 사용자 지정하는 방법을 보여 주는 전체 코드 예제를 볼 수 있습니다.

XAML 기반 데스크톱 애플리케이션의 경우 메뉴 플라이아웃을 사용하여 상황에 맞는 메뉴를 구현하는 것이 좋습니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX) 및 다중 스레드 환경(.NET)에서 Windows 런타임 개체 사용을 참조하세요.

생성자

PopupMenu()

PopupMenu 클래스의 새 instance 만듭니다.

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.

속성

Commands

상황에 맞는 메뉴에 대한 명령을 가져옵니다.

메서드

ShowAsync(Point)

지정된 클라이언트 좌표의 상황에 맞는 메뉴를 표시합니다.
ShowForSelectionAsync(Rect)

지정된 선택 영역 위의 상황에 맞는 메뉴를 표시합니다.
ShowForSelectionAsync(Rect, Placement)

지정한 선택 영역을 기준으로 기본 배치의 상황에 맞는 메뉴를 표시합니다.

적용 대상

추가 정보