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
Текстовая строка, отображаемая для пользовательского средства.
Настраиваемый значок, отображаемый для пользовательского средства.
Возвращаемое значение
Пользовательское средство.
Комментарии
Операции меню RadialController, включая CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems и TrySelectDefaultMenuItem, должны выполняться в потоке пользовательского интерфейса. Это в фоновом рабочем потоке может вызвать проблемы с обработчиками событий в потоке пользовательского интерфейса.
Рекомендации по взаимодействию с пользователем для Surface Dial рекомендуют следующее:
Text
- Имена должны быть короткими, чтобы помещаться в центральном круге меню колесика
- Имена должны четко определять основное действие (может подразумеваться дополнительное действие).
- прокрутка означает движение в обоих направлениях поворота;
- отмена указывает основное действие, но повтор (вспомогательное действие) может подразумеваться и легко может быть обнаружен пользователем.
Значки
- Предоставьте высококачественные изображения в формате PNG размером 64 x 64 пикселя (минимальный поддерживаемый размер — 44 x 44)
- Убедитесь, что фон прозрачный
- Значок должны заполнять большую часть изображения
- У белого значка должен быть черный контур, чтобы он был виден в режиме высокой контрастности