Поделиться через


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

Настраиваемый значок, отображаемый для пользовательского средства.

Возвращаемое значение

Пользовательское средство.

Комментарии

Операции меню RadialController, включая CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems и TrySelectDefaultMenuItem, должны выполняться в потоке пользовательского интерфейса. Это в фоновом рабочем потоке может вызвать проблемы с обработчиками событий в потоке пользовательского интерфейса.

Рекомендации по взаимодействию с пользователем для Surface Dial рекомендуют следующее:

Text

  • Имена должны быть короткими, чтобы помещаться в центральном круге меню колесика
  • Имена должны четко определять основное действие (может подразумеваться дополнительное действие).
  • прокрутка означает движение в обоих направлениях поворота;
  • отмена указывает основное действие, но повтор (вспомогательное действие) может подразумеваться и легко может быть обнаружен пользователем.

Значки

  • Предоставьте высококачественные изображения в формате PNG размером 64 x 64 пикселя (минимальный поддерживаемый размер — 44 x 44)
  • Убедитесь, что фон прозрачный
  • Значок должны заполнять большую часть изображения
  • У белого значка должен быть черный контур, чтобы он был виден в режиме высокой контрастности

Применяется к

См. также раздел