共用方式為


RadialControllerMenuItem.CreateFromIcon 方法

定義

使用 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

要針對自訂工具顯示的文字字串。

icon
RandomAccessStreamReference

要針對自訂工具顯示的自訂圖示。

傳回

自訂工具。

備註

RadialController功能表作業,包括CreateFromKnownIcon、CreateFromIconCreateFromFontGlyphCreateFromFontGlyphResetToDefaultMenuItems、SetDefaultMenuItemsTrySelectDefaultMenuItem,都應該在 UI 執行緒上執行。 在背景背景背景工作執行緒中這樣做可能會導致 UI 執行緒上的事件處理常式發生問題。

Surface Dial 的UX 指導方針建議下列事項:

Text

  • 名稱應該要簡短到可以放入滾輪功能表的中央圓形內
  • 名稱應該清楚識別主要動作, (補充動作可以隱含)
  • 捲軸指出兩個旋轉方向的效果
  • 復原指定主要動作,但是使用者可以推斷和輕鬆探索重做 (補充動作)

圖示

  • 提供高品質 64 x 64 像素的 PNG 影像 (最小支援 44 x 44)
  • 確保背景是透明的
  • 圖示應該填滿大部分的影像
  • 白色圖示要有一個黑色外框可在高對比模式中顯示

適用於

另請參閱