RadialControllerMenuItem.CreateFromFontGlyph Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
CreateFromFontGlyph(String, String, String) |
Создает пользовательское средство (используя указанную текстовую строку и глиф шрифта) в меню RadialController . |
CreateFromFontGlyph(String, String, String, Uri) |
Создает пользовательское средство (используя указанную текстовую строку и глиф шрифта) в меню RadialController . |
CreateFromFontGlyph(String, String, String)
Создает пользовательское средство (используя указанную текстовую строку и глиф шрифта) в меню RadialController .
public:
static RadialControllerMenuItem ^ CreateFromFontGlyph(Platform::String ^ displayText, Platform::String ^ glyph, Platform::String ^ fontFamily);
/// [Windows.Foundation.Metadata.Overload("CreateFromFontGlyph")]
static RadialControllerMenuItem CreateFromFontGlyph(winrt::hstring const& displayText, winrt::hstring const& glyph, winrt::hstring const& fontFamily);
[Windows.Foundation.Metadata.Overload("CreateFromFontGlyph")]
public static RadialControllerMenuItem CreateFromFontGlyph(string displayText, string glyph, string fontFamily);
function createFromFontGlyph(displayText, glyph, fontFamily)
Public Shared Function CreateFromFontGlyph (displayText As String, glyph As String, fontFamily As String) As RadialControllerMenuItem
Параметры
- displayText
-
String
Platform::String
winrt::hstring
Текстовая строка, отображаемая для пользовательского средства.
- glyph
-
String
Platform::String
winrt::hstring
Глиф шрифта, отображаемый для пользовательского инструмента.
- fontFamily
-
String
Platform::String
winrt::hstring
Семейство шрифтов, содержащее глиф, отображаемый для пользовательского инструмента.
Возвращаемое значение
Пользовательское средство.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 Creators Update (появилось в 10.0.15063.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v4.0)
|
Комментарии
Используйте эту перегрузку метода при ссылке на шрифт, уже установленный в системе. В противном случае используйте createFromFontGlyph(String displayText, String glyph, String fontFamily, Uri fontUri).
Операции меню RadialController, включая CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems и TrySelectDefaultMenuItem, должны выполняться в потоке пользовательского интерфейса. Это в фоновом рабочем потоке может вызвать проблемы с обработчиками событий в потоке пользовательского интерфейса.
Рекомендации по взаимодействию с пользователем для Surface Dial рекомендуют следующее:
-
Text
- Имена должны быть короткими, чтобы помещаться в центральном круге меню колесика
- Имена должны четко определять основное действие (может подразумеваться дополнительное действие).
- прокрутка означает движение в обоих направлениях поворота;
- отмена указывает основное действие, но повтор (вспомогательное действие) может подразумеваться и легко может быть обнаружен пользователем.
См. также раздел
- CreateFromFontGlyph(String, String, String, Uri)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Взаимодействие с Surface Dial
- Примеры для универсальной платформы Windows (C# и C++)
- Пример рабочего стола Windows
Применяется к
CreateFromFontGlyph(String, String, String, Uri)
Создает пользовательское средство (используя указанную текстовую строку и глиф шрифта) в меню RadialController .
public:
static RadialControllerMenuItem ^ CreateFromFontGlyph(Platform::String ^ displayText, Platform::String ^ glyph, Platform::String ^ fontFamily, Uri ^ fontUri);
/// [Windows.Foundation.Metadata.Overload("CreateFromFontGlyphWithUri")]
static RadialControllerMenuItem CreateFromFontGlyph(winrt::hstring const& displayText, winrt::hstring const& glyph, winrt::hstring const& fontFamily, Uri const& fontUri);
[Windows.Foundation.Metadata.Overload("CreateFromFontGlyphWithUri")]
public static RadialControllerMenuItem CreateFromFontGlyph(string displayText, string glyph, string fontFamily, System.Uri fontUri);
function createFromFontGlyph(displayText, glyph, fontFamily, fontUri)
Public Shared Function CreateFromFontGlyph (displayText As String, glyph As String, fontFamily As String, fontUri As Uri) As RadialControllerMenuItem
Параметры
- displayText
-
String
Platform::String
winrt::hstring
Текстовая строка, отображаемая для пользовательского средства.
- glyph
-
String
Platform::String
winrt::hstring
Глиф шрифта, отображаемый для пользовательского инструмента.
- fontFamily
-
String
Platform::String
winrt::hstring
Семейство шрифтов, содержащее глиф, отображаемый для пользовательского инструмента.
Универсальный код ресурса (URI), определяющий расположение шрифта, используемого для отрисовки глифа.
Возвращаемое значение
Пользовательское средство.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 Creators Update (появилось в 10.0.15063.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v4.0)
|
Комментарии
При использовании этой перегрузки метода для ссылки на глиф шрифтов, установленный в пакете appx приложения, приложение может отображать неработающий образ при развертывании из Visual Studio. В этом случае необходимо сначала создать пакет приложения (Project-Store-CreateAppPackage>>), а затем развернуть.
Операции меню RadialController, включая CreateFromKnownIcon, CreateFromIcon, CreateFromFontGlyph, CreateFromFontGlyph, ResetToDefaultMenuItems, SetDefaultMenuItems и TrySelectDefaultMenuItem, должны выполняться в потоке пользовательского интерфейса. Это в фоновом рабочем потоке может вызвать проблемы с обработчиками событий в потоке пользовательского интерфейса.
Рекомендации по взаимодействию с пользователем для Surface Dial рекомендуют следующее:
-
Text
- Имена должны быть короткими, чтобы помещаться в центральном круге меню колесика
- Имена должны четко определять основное действие (может подразумеваться дополнительное действие).
- прокрутка означает движение в обоих направлениях поворота;
- отмена указывает основное действие, но повтор (вспомогательное действие) может подразумеваться и легко может быть обнаружен пользователем.
См. также раздел
- CreateFromFontGlyph(String, String, String)
- CreateFromIcon(String, RandomAccessStreamReference)
- CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
- Взаимодействие с Surface Dial
- Примеры для универсальной платформы Windows (C# и C++)
- Пример рабочего стола Windows