次の方法で共有


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) を使用します。

CreateFromKnownIcon、CreateFromIconCreateFromFontGlyph、CreateFromFontGlyphResetToDefaultMenuItemsSetDefaultMenuItemsTrySelectDefaultMenuItem などの RadialController メニュー操作は、UI スレッドで実行する必要があります。 バックグラウンド ワーカー スレッドでこれを行うと、UI スレッドのイベント ハンドラーで問題が発生する可能性があります。

Surface Dial の UX ガイドラインでは、次のことをお勧めします。

  • 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

グリフのレンダリングに使用されるフォントの場所を識別する Uniform Resource Identifier (URI)。

戻り値

カスタム ツール。

属性

Windows の要件

デバイス ファミリ
Windows 10 Creators Update (10.0.15063.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v4.0 で導入)

注釈

このメソッド オーバーロードを使用してアプリの appx パッケージと共にインストールされたフォント グリフを参照する場合、Visual Studio からデプロイすると、アプリに壊れたイメージが表示されることがあります。 この場合は、最初にアプリ パッケージ (Project-Store-CreateAppPackage>>) を作成してから配置する必要があります。

CreateFromKnownIcon、CreateFromIconCreateFromFontGlyphCreateFromFontGlyphResetToDefaultMenuItemsSetDefaultMenuItemsTrySelectDefaultMenuItem などの RadialController メニュー操作は、UI スレッドで実行する必要があります。 バックグラウンド ワーカー スレッドでこれを行うと、UI スレッドのイベント ハンドラーで問題が発生する可能性があります。

Surface Dial の UX ガイドラインでは、次のことをお勧めします。

  • Text
    • 名前は、ホイール メニューの中心の円内に収まるように短くする必要がある
    • 名前は主なアクションを明確に識別する必要があります (補完的なアクションを暗黙的に指定できます)
    • スクロールは両方の回転方向の効果を示す
    • ([元に戻す] はプライマリ操作を指定するが、ユーザーは簡単に [やり直し)] (補完的なアクション) を推測して検出できる

こちらもご覧ください

適用対象