RadialControllerMenuItem.CreateFromKnownIcon Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает пользовательский инструмент (используя указанную текстовую строку и системный значок) в меню RadialController .
public:
static RadialControllerMenuItem ^ CreateFromKnownIcon(Platform::String ^ displayText, RadialControllerMenuKnownIcon value);
static RadialControllerMenuItem CreateFromKnownIcon(winrt::hstring const& displayText, RadialControllerMenuKnownIcon const& value);
public static RadialControllerMenuItem CreateFromKnownIcon(string displayText, RadialControllerMenuKnownIcon value);
function createFromKnownIcon(displayText, value)
Public Shared Function CreateFromKnownIcon (displayText As String, value As RadialControllerMenuKnownIcon) As RadialControllerMenuItem
Параметры
- displayText
-
String
Platform::String
winrt::hstring
Текстовая строка, отображаемая для пользовательского средства.
Системный значок, отображаемый для пользовательского инструмента.
Возвращаемое значение
Пользовательское средство.
Комментарии
Операции меню RadialController, включая CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems и TrySelectDefaultMenuItem, должны выполняться в потоке пользовательского интерфейса. Это в фоновом рабочем потоке может вызвать проблемы с обработчиками событий в потоке пользовательского интерфейса.
Рекомендации по взаимодействию с пользователем для Surface Dial рекомендуют следующее:
Text
- Имена должны быть короткими, чтобы помещаться в центральном круге меню колесика
- Имена должны четко определять основное действие (может подразумеваться дополнительное действие).
- прокрутка означает движение в обоих направлениях поворота;
- отмена указывает основное действие, но повтор (вспомогательное действие) может подразумеваться и легко может быть обнаружен пользователем.