通过

RadialControllerMenuItem.CreateFromFontGlyph 方法

  • 参考

定义

命名空间:
Windows.UI.Input

重载

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

包含要为自定义工具显示的字形的字体系列。

返回

RadialControllerMenuItem

自定义工具。

属性
OverloadAttribute

Windows 要求

设备系列
Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

引用系统上已安装的字体时，请使用此方法重载。 否则，请使用 CreateFromFontGlyph (String displayText、String 字形、String fontFamily、Uri fontUri) 。

RadialController 菜单操作（包括 CreateFromKnownIcon、 CreateFromIcon、 CreateFromFontGlyph、CreateFromFontGlyph、 ResetToDefaultMenuItems、 SetDefaultMenuItems 和 TrySelectDefaultMenuItem）应在 UI 线程上执行。 在后台工作线程中执行此操作可能会导致 UI 线程上的事件处理程序出现问题。

Surface Dial 的 UX 指南建议：

  • 文本
    • 名称应短到足以放入 Wheel 菜单的中心圆圈内
    • 名称应清楚地标识主要操作 (可以暗示补充操作)
    • “滚动”指示两个旋转方向的效果
    • “撤消”指定主要操作，但用户可以推断和轻松地发现“重做”（互补操作）

另请参阅

适用于

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) ，用于标识用于呈现字形的字体的位置。

返回

RadialControllerMenuItem

自定义工具。

属性
OverloadAttribute

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）应在 UI 线程上执行。 在后台工作线程中执行此操作可能会导致 UI 线程上的事件处理程序出现问题。

Surface Dial 的 UX 指南建议：

  • 文本
    • 名称应短到足以放入 Wheel 菜单的中心圆圈内
    • 名称应清楚地标识主要操作 (可以暗示补充操作)
    • “滚动”指示两个旋转方向的效果
    • “撤消”指定主要操作，但用户可以推断和轻松地发现“重做”（互补操作）

另请参阅

适用于