SecondaryTile コンストラクター

定義

名前空間:

Windows.UI.StartScreen

オーバーロード

SecondaryTile()	SecondaryTile オブジェクトを作成します。 呼び出し元は、タイルをピン留め、更新、または削除する前に、オブジェクトを通じて必須プロパティを設定する必要があります。 デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。
SecondaryTile(String)	特定の ID を持つ SecondaryTile オブジェクトを作成します。 この形式のコンストラクターを使用して、タイルの更新または削除を実行するセカンダリ タイル オブジェクトを作成する必要があります。 デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。
SecondaryTile(String, String, String, Uri, TileSize)	中のタイルを作成するために必要なすべての必須プロパティを含む SecondaryTile オブジェクトを作成します。 デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。
SecondaryTile(String, String, String, String, TileOptions, Uri)	Note このコンストラクターは、Windows 8.1後のリリースでは変更または使用できない場合があります。 代わりに、 SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) を使用します。 中のタイルとして SecondaryTile オブジェクトを作成します。 デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	Note このコンストラクターは、Windows 8.1後のリリースでは変更または使用できない場合があります。 代わりに、 SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) を使用し、 SecondaryTile.VisualElements メソッドを使用して他のタイル サイズとオプションを指定します。 SecondaryTile オブジェクトをワイド タイルとして作成します。 デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。 Windows Phone 8.1 では、セカンダリ タイルを含むすべてのタイルが中タイルとしてピン留めされ、その後、ユーザーがサイズを変更できます。 このコンストラクターは、幅の広いタイルにサイズ変更するオプションを提供します。

SecondaryTile()

SecondaryTile オブジェクトを作成します。 呼び出し元は、タイルをピン留め、更新、または削除する前に、オブジェクトを通じて必須プロパティを設定する必要があります。

デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

注釈

表示名などの必須のタイル プロパティは、タイルをアクティブ化する前に、このクラスの他のメソッドを呼び出して設定する必要があります。

SecondaryTile(String)

特定の ID を持つ SecondaryTile オブジェクトを作成します。 この形式のコンストラクターを使用して、タイルの更新または削除を実行するセカンダリ タイル オブジェクトを作成する必要があります。

デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

public:
 SecondaryTile(Platform::String ^ tileId);

 SecondaryTile(winrt::hstring const& tileId);

public SecondaryTile(string tileId);

function SecondaryTile(tileId)

Public Sub New (tileId As String)

パラメーター

tileId

String

Platform::String

winrt::hstring

アプリ内のタイルを一意に識別する文字列。 アプリにわかりやすい一意の ID を選択します。 既存のセカンダリ タイルと同じ ID を指定すると、既存のセカンダリ タイルが上書きされます。

注釈

このタイルの作成に使用する一意の ID は、後で更新または削除するために使用できます。

表示名などの他の必須タイル プロパティは、タイルをアクティブ化する前に、このクラスの他のメソッドを呼び出して設定する必要があります。

SecondaryTile(String, String, String, Uri, TileSize)

中のタイルを作成するために必要なすべての必須プロパティを含む SecondaryTile オブジェクトを作成します。

デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ displayName, Platform::String ^ arguments, Uri ^ square150x150Logo, TileSize desiredSize);

 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& displayName, winrt::hstring const& arguments, Uri const& square150x150Logo, TileSize const& desiredSize);

public SecondaryTile(string tileId, string displayName, string arguments, System.Uri square150x150Logo, TileSize desiredSize);

function SecondaryTile(tileId, displayName, arguments, square150x150Logo, desiredSize)

Public Sub New (tileId As String, displayName As String, arguments As String, square150x150Logo As Uri, desiredSize As TileSize)

パラメーター

tileId

String

Platform::String

winrt::hstring

アプリのパッケージ内のタイルを一意に識別する文字列。 アプリにわかりやすい一意の ID を選択します。 これは 64 文字に制限されており、数字または文字で始まり、a から z、A-Z、0 から 9、ピリオド (.)、またはアンダースコア (_) で構成する必要があります。 既存のセカンダリ タイルと同じ ID を指定すると、既存のセカンダリ タイルが上書きされます。 TileId プロパティを使用して設定または取得できます。

displayName

String

Platform::String

winrt::hstring

タイルに表示する名前、タイルのツールヒント、および小さなタイル ( アプリ や検索結果画面など) を表示する場合に表示する名前。 この文字列は、メイン タイルのマニフェストで指定された表示名と同じです。 256 文字に制限されていますが、切り捨てを避けるために、実際には短くする必要があります。 この値は、 DisplayName プロパティを使用して設定または取得できます。

表示名は、Windows Phone 8.1 のワイド セカンダリ タイルにのみ表示されます。

arguments

String

Platform::String

winrt::hstring

呼び出し元のアプリケーションに意味のあるアプリ定義の文字列。 この引数文字列は、アプリがセカンダリ タイルからアクティブ化されるときに、アプリに返されます。 2048 文字より後に切り捨てられます。 Arguments プロパティを使用して設定または取得できます。

Note

このパラメーターは、silverlight 8.1 アプリWindows Phone URL エンコードされている必要があります。 他のすべてのアプリの種類では、独自の構造を使用できます。

square150x150Logo

Uri Uri

Uniform Resource Identifier (URI) に格納されている中程度のロゴ イメージへの参照。 SecondaryTileVisualElements.Square150x150Logo プロパティを使用して設定または取得できます。 この値は、デプロイされたアプリ パッケージ内の ms-appx:/// A パスのいずれかのスキームを使用して表すことができます。 このパスは、アプリでサポートされている言語と DPI プラトーで解決されます。ms-appdata:///local/ ユーザーごとのアプリ ストレージに見つかったファイル。

desiredSize

TileSize

ピン留めするタイルのサイズ。 この値は Default (Windows 8 の動作を提供する)、 Square150x150、または Wide310x150 である必要があります。 他の TileSize 値を指定すると、実行時に例外がスローされます。

desiredSize パラメーターは、Windows Phone 8.1 では無視されます。 電話では、セカンダリ タイルを含むすべてのタイルが中程度のタイルとしてピン留めされ、その後、ユーザーがサイズを変更できます。

SecondaryTile(String, String, String, String, TileOptions, Uri)

Note

このコンストラクターは、Windows 8.1後のリリースでは変更または使用できない場合があります。 代わりに、 SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) を使用します。

中のタイルとして SecondaryTile オブジェクトを作成します。

デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference);

function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference)

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri)

パラメーター

tileId

String

Platform::String

winrt::hstring

アプリのパッケージ内のタイルを一意に識別する文字列。 アプリにわかりやすい一意の ID を選択します。 これは 64 文字に制限されており、数字または文字で始まり、a から z、A-Z、0 から 9、ピリオド (.)、またはアンダースコア (_) で構成する必要があります。 既存のセカンダリ タイルと同じ ID を指定すると、既存のセカンダリ タイルが上書きされます。 TileId プロパティを使用して設定または取得できます。

shortName

String

Platform::String

winrt::hstring

アプリでこれを行う場合にタイルに直接表示する短い名前。 40 文字を超える文字はすべて切り捨てられます。 ユーザーには、ピン留めプロセスの一部としてこの値を変更するオプションがあります。 ShortName プロパティを使用して設定または取得できます。

Note

この値は Windows 8 でのみ使用され、新しいバージョンでは displayName を優先して非推奨とされています。

displayName

String

Platform::String

winrt::hstring

タイルに表示する名前、タイルのツールヒント、および小さなタイル ( アプリ や検索結果画面など) を表示する場合に表示する名前。 この文字列は、メイン タイルのマニフェストで指定された表示名と同じです。 256 文字に制限されていますが、切り捨てを避けるために、実際には短くする必要があります。 この値は、 DisplayName プロパティを使用して設定または取得できます。

表示名は、Windows Phone 8.1 のワイド セカンダリ タイルにのみ表示されます。

arguments

String

Platform::String

winrt::hstring

呼び出し元のアプリケーションに意味のあるアプリ定義の文字列。 この引数文字列は、アプリがセカンダリ タイルからアクティブ化されるときに、アプリに返されます。 2048 文字より後に切り捨てられます。 Arguments プロパティを使用して設定または取得できます。

tileOptions

TileOptions

セカンダリ タイルに名前を表示するかどうかなど、さまざまなオプションを指定する 値。 TileOptions プロパティを使用して設定または取得できます。

logoReference

Uri Uri

Uniform Resource Identifier (URI) に格納されている正方形のロゴ イメージへの参照。 Logo プロパティを使用して設定または取得できます。 この値は、デプロイされたアプリ パッケージ内の ms-appx:/// A パスのいずれかのスキームを使用して表すことができます。 このパスは、アプリでサポートされている言語と DPI プラトーで解決されます。ms-appdata:///local/ ユーザーごとのアプリ ストレージに見つかったファイル。

属性

DeprecatedAttribute

SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)

Note

このコンストラクターは、Windows 8.1後のリリースでは変更または使用できない場合があります。 代わりに、 SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) を使用し、 SecondaryTile.VisualElements メソッドを使用して他のタイル サイズとオプションを指定します。

SecondaryTile オブジェクトをワイド タイルとして作成します。

デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「 CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照してください。

Windows Phone 8.1 では、セカンダリ タイルを含むすべてのタイルが中タイルとしてピン留めされ、その後、ユーザーがサイズを変更できます。 このコンストラクターは、幅の広いタイルにサイズ変更するオプションを提供します。

public:
 SecondaryTile(Platform::String ^ tileId, Platform::String ^ shortName, Platform::String ^ displayName, Platform::String ^ arguments, TileOptions tileOptions, Uri ^ logoReference, Uri ^ wideLogoReference);

/// [Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 SecondaryTile(winrt::hstring const& tileId, winrt::hstring const& shortName, winrt::hstring const& displayName, winrt::hstring const& arguments, TileOptions const& tileOptions, Uri const& logoReference, Uri const& wideLogoReference);

[Windows.Foundation.Metadata.Deprecated("SecondaryTile(string, string, string, string, Windows.UI.StartScreen.TileOptions, Windows.Foundation.Uri, Windows.Foundation.Uri) may be altered or unavailable for releases after Windows Phone 8.1. Instead, use SecondaryTile(string, string, string, Windows.Foundation.Uri, Windows.UI.StartScreen.TileSize).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public SecondaryTile(string tileId, string shortName, string displayName, string arguments, TileOptions tileOptions, System.Uri logoReference, System.Uri wideLogoReference);

function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference, wideLogoReference)

Public Sub New (tileId As String, shortName As String, displayName As String, arguments As String, tileOptions As TileOptions, logoReference As Uri, wideLogoReference As Uri)

パラメーター

tileId

String

Platform::String

winrt::hstring

アプリのパッケージ内のタイルを一意に識別する文字列。 アプリにわかりやすい一意の ID を選択します。 これは 64 文字に制限されており、数字または文字で始まり、a から z、A-Z、0 から 9、ピリオド (.)、またはアンダースコア (_) で構成する必要があります。 既存のセカンダリ タイルと同じ ID を指定すると、既存のセカンダリ タイルが上書きされます。 TileId プロパティを使用して設定または取得できます。

shortName

String

Platform::String

winrt::hstring

アプリでこれを行う場合にタイルに直接表示する短い名前。 40 文字を超える文字はすべて切り捨てられます。 ユーザーには、ピン留めプロセスの一部としてこの値を変更するオプションがあります。 ShortName プロパティを使用して設定または取得できます。

Note

この値は Windows 8 でのみ使用され、新しいバージョンでは displayName を優先して非推奨とされています。

displayName

String

Platform::String

winrt::hstring

タイルに表示する名前、タイルのツールヒント、および小さなタイル ( アプリ や検索結果画面など) を表示する場合に表示する名前。 この文字列は、メイン タイルのマニフェストで指定された表示名と同じです。 256 文字に制限されていますが、切り捨てを避けるために、実際には短くする必要があります。 この値は、 DisplayName プロパティを使用して設定または取得できます。

表示名は、Windows Phone 8.1 のワイド セカンダリ タイルにのみ表示されます。

arguments

String

Platform::String

winrt::hstring

呼び出し元のアプリケーションに意味のあるアプリ定義の文字列。 この引数文字列は、アプリがセカンダリ タイルからアクティブ化されるときに、アプリに返されます。 2048 文字より後に切り捨てられます。 Arguments プロパティを使用して設定または取得できます。

tileOptions

TileOptions

セカンダリ タイルに名前を表示するかどうかなど、さまざまなオプションを指定する 値。 TileOptions プロパティを使用して設定または取得できます。

logoReference

Uri Uri

Uniform Resource Identifier (URI) に格納されている中程度のロゴ イメージへの参照。 Square150x150Logo プロパティを使用して設定または取得できます。 この値は、デプロイされたアプリ パッケージ内の ms-appx:/// A パスのいずれかのスキームを使用して表すことができます。 このパスは、アプリでサポートされている言語と DPI プラトーで解決されます。ms-appdata:///local/ ユーザーごとのアプリ ストレージに見つかったファイル。

wideLogoReference

Uri Uri

Uniform Resource Identifier (URI) に格納されているワイド ロゴ イメージへの参照。 WideLogo プロパティを使用して設定または取得できます。 この値は、デプロイされたアプリ パッケージ内の ms-appx:/// A パスのいずれかのスキームを使用して表すことができます。 このパスは、アプリでサポートされている言語と DPI プラトーで解決されます。ms-appdata:///local/ ユーザーごとのアプリ ストレージに見つかったファイル。

属性

DeprecatedAttribute