RadialControllerMenuItem.CreateFromIcon 메서드

정의

RadialController 메뉴에서 지정된 텍스트 문자열 및 사용자 지정 아이콘을 사용하여 사용자 지정 도구를 만듭니다.

public:
 static RadialControllerMenuItem ^ CreateFromIcon(Platform::String ^ displayText, RandomAccessStreamReference ^ icon);
 static RadialControllerMenuItem CreateFromIcon(winrt::hstring const& displayText, RandomAccessStreamReference const& icon);
public static RadialControllerMenuItem CreateFromIcon(string displayText, RandomAccessStreamReference icon);
function createFromIcon(displayText, icon)
Public Shared Function CreateFromIcon (displayText As String, icon As RandomAccessStreamReference) As RadialControllerMenuItem

매개 변수

displayText
String

Platform::String

winrt::hstring

사용자 지정 도구에 대해 표시할 텍스트 문자열입니다.

icon
RandomAccessStreamReference

사용자 지정 도구에 대해 표시할 사용자 지정 아이콘입니다.

반환

사용자 지정 도구입니다.

설명

CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItemsTrySelectDefaultMenuItem을 포함한 RadialController 메뉴 작업은 UI 스레드에서 수행해야 합니다. 백그라운드 작업자 스레드에서 이 작업을 수행하면 UI 스레드의 이벤트 처리기에 문제가 발생할 수 있습니다.

Surface Dial에 대한 UX 지침은 다음을 권장합니다.

Text

  • 이름은 휠 메뉴의 중앙 원 안에 맞게 줄여야 합니다.
  • 이름은 기본 작업을 명확하게 식별해야 합니다(보완 작업을 암시할 수 있음).
  • 스크롤은 양쪽 회전 방향의 효과를 나타냅니다.
  • 실행 취소는 기본 동작을 지정하지만 다시 실행(보조 작업)은 사용자가 유추하고 쉽게 검색할 수 있습니다.

아이콘

  • 고품질 64x64 픽셀 PNG 이미지를 제공합니다(최소 지원 크기: 44x44).
  • 투명 배경인지 확인합니다.
  • 아이콘이 이미지 대부분을 채워야 합니다.
  • 고대비 모드에서 보이도록 흰색 아이콘에 검은색 윤곽을 지정합니다.

적용 대상

추가 정보