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 glyph, String fontFamily, Uri fontUri) を使用します。

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

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

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

こちらもご覧ください

• CreateFromFontGlyph(String, String, String, Uri)
• CreateFromIcon(String, RandomAccessStreamReference)
• CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
• Surface Dial の操作
• ユニバーサル Windows プラットフォームのサンプル (C# と C++)
• Windows デスクトップのサンプル

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)。

戻り値

RadialControllerMenuItem

カスタム ツール。

属性

OverloadAttribute

Windows の要件

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

注釈

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

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

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

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

こちらもご覧ください

• CreateFromFontGlyph(String, String, String)
• CreateFromIcon(String, RandomAccessStreamReference)
• CreateFromKnownIcon(String, RadialControllerMenuKnownIcon)
• Surface Dial の操作
• ユニバーサル Windows プラットフォームのサンプル (C# と C++)
• Windows デスクトップのサンプル