RadialControllerMenuItem.CreateFromFontGlyph メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
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、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
カスタム ツールに表示するグリフを含むフォント ファミリ。
戻り値
カスタム ツール。
- 属性
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 デスクトップのサンプル