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 指導方針建議下列事項:
Text
- 名稱應該要簡短到可以放入滾輪功能表的中央圓形內
- 名稱應該清楚識別主要動作, (補充動作可以隱含)
- 捲軸指出兩個旋轉方向的效果
- 復原指定主要動作,但是使用者可以推斷和輕鬆探索重做 (補充動作)
圖示
- 提供高品質 64 x 64 像素的 PNG 影像 (最小支援 44 x 44)
- 確保背景是透明的
- 圖示應該填滿大部分的影像
- 白色圖示要有一個黑色外框可在高對比模式中顯示