RadialControllerMenuItem.CreateFromIcon 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在 (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)应在 UI 线程上执行。 在后台工作线程中执行此操作可能会导致 UI 线程上的事件处理程序出现问题。
Surface Dial 的 UX 指南建议:
文本
- 名称应短到足以放入 Wheel 菜单的中心圆圈内
- 名称应清楚地标识主要操作 (可以隐含补充操作)
- “滚动”指示两个旋转方向的效果
- “撤消”指定主要操作,但用户可以推断和轻松地发现“重做”(互补操作)
图标
- 提供 64 x 64 像素的高质量 PNG 图像(44 x 44 为受支持的最小像素)
- 确保背景透明
- 图标应填满图像的大部分
- 白色图标应具有黑色边框才能在高对比度模式下可见