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


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)

Создает пользовательское средство (используя указанную текстовую строку и глиф шрифта) в меню 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

Семейство шрифтов, содержащее глиф, отображаемый для пользовательского инструмента.

fontUri
Uri Uri

Универсальный код ресурса (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
    • Имена должны быть короткими, чтобы помещаться в центральном круге меню колесика
    • Имена должны четко определять основное действие (может подразумеваться дополнительное действие).
    • прокрутка означает движение в обоих направлениях поворота;
    • отмена указывает основное действие, но повтор (вспомогательное действие) может подразумеваться и легко может быть обнаружен пользователем.

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

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