SecondaryTile Konstruktoren

Definition

Namespace:

Windows.UI.StartScreen

Überlädt

SecondaryTile()	Erstellt ein SecondaryTile-Objekt . Der Aufrufer muss dann alle obligatorischen Eigenschaften über das -Objekt festlegen, bevor er versucht, die Kachel anzuheften, zu aktualisieren oder zu löschen. Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.
SecondaryTile(String)	Erstellt ein SecondaryTile-Objekt mit einer bestimmten ID. Diese Form des Konstruktors sollte verwendet werden, um ein sekundäres Kachelobjekt zu erstellen, um eine Kachelaktualisierung oder -löschung durchzuführen. Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.
SecondaryTile(String, String, String, Uri, TileSize)	Erstellt ein SecondaryTile-Objekt , das alle obligatorischen Eigenschaften enthält, die zum Erstellen einer mittleren Kachel erforderlich sind. Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.
SecondaryTile(String, String, String, String, TileOptions, Uri)	Hinweis Dieser Konstruktor kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize). Erstellt ein SecondaryTile-Objekt als mittlere Kachel. Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)	Hinweis Dieser Konstruktor kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) und geben Sie andere Kachelgrößen und Optionen über die SecondaryTile.VisualElements-Methode an . Erstellt ein SecondaryTile-Objekt als breite Kachel. Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen. In Windows Phone 8.1 werden alle Kacheln – einschließlich sekundärer Kacheln – als mittlere Kacheln angeheftet, nach denen die Größe vom Benutzer geändert werden kann. Dieser Konstruktor bietet die Möglichkeit, die Größe in eine breite Kachel zu ändern.

SecondaryTile()

Erstellt ein SecondaryTile-Objekt . Der Aufrufer muss dann alle obligatorischen Eigenschaften über das -Objekt festlegen, bevor er versucht, die Kachel anzuheften, zu aktualisieren oder zu löschen.

Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

public:
 SecondaryTile();

 SecondaryTile();

public SecondaryTile();

function SecondaryTile()

Public Sub New ()

Hinweise

Obligatorische Kacheleigenschaften, z. B. der Anzeigename, müssen über Aufrufe anderer Methoden dieser Klasse festgelegt werden, bevor die Kachel aktiviert werden kann.

SecondaryTile(String)

Erstellt ein SecondaryTile-Objekt mit einer bestimmten ID. Diese Form des Konstruktors sollte verwendet werden, um ein sekundäres Kachelobjekt zu erstellen, um eine Kachelaktualisierung oder -löschung durchzuführen.

Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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

 SecondaryTile(winrt::hstring const& tileId);

public SecondaryTile(string tileId);

function SecondaryTile(tileId)

Public Sub New (tileId As String)

Parameter

tileId

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die Kachel in Ihrer App eindeutig identifiziert. Wählen Sie eine eindeutige ID aus, die für Ihre App aussagekräftig und aussagekräftig ist. Wenn Sie dieselbe ID wie eine vorhandene sekundäre Kachel angeben, wird die vorhandene sekundäre Kachel überschrieben.

Hinweise

Die eindeutige ID, die Sie zum Erstellen dieser Kachel verwenden, kann später verwendet werden, um sie zu aktualisieren oder zu löschen.

Andere obligatorische Kacheleigenschaften, z. B. der Anzeigename, müssen über Aufrufe anderer Methoden dieser Klasse festgelegt werden, bevor die Kachel aktiviert werden kann.

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

Erstellt ein SecondaryTile-Objekt , das alle obligatorischen Eigenschaften enthält, die zum Erstellen einer mittleren Kachel erforderlich sind.

Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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)

Parameter

tileId

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die Kachel im App-Paket eindeutig identifiziert. Wählen Sie eine eindeutige ID aus, die für Ihre App aussagekräftig und aussagekräftig ist. Er ist auf 64 Zeichen beschränkt und muss mit einer Zahl oder einem Buchstaben beginnen und aus den Zeichen a-z, A-Z, 0-9, Punkt (.) oder Unterstrich (_) bestehen. Wenn Sie dieselbe ID wie eine vorhandene sekundäre Kachel angeben, wird die vorhandene sekundäre Kachel überschrieben. Kann über die TileId-Eigenschaft festgelegt oder abgerufen werden.

displayName

String

Platform::String

winrt::hstring

Ein Name, der auf der Kachel, in der QuickInfo der Kachel und beim Anzeigen kleiner Kacheln angezeigt werden soll, z. B. auf den Bildschirmen "Apps " oder "Suchergebnisse". Diese Zeichenfolge entspricht dem Anzeigenamen, der im Manifest für die Kachel Standard angegeben wird. Es ist auf 256 Zeichen beschränkt, sollte aber in der Praxis kurz gehalten werden, um abgeschnitten zu werden. Dieser Wert kann über die DisplayName-Eigenschaft festgelegt oder abgerufen werden.

Der Anzeigename wird nur auf der breiten sekundären Kachel auf Windows Phone 8.1 angezeigt.

arguments

String

Platform::String

winrt::hstring

Eine von der App definierte Zeichenfolge, die für die aufrufende Anwendung sinnvoll ist. Diese Argumentzeichenfolge wird zurück an die App übergeben, wenn die App von der sekundären Kachel aus aktiviert wird. Sie wird nach 2048 Zeichen abgeschnitten. Kann über die Arguments-Eigenschaft festgelegt oder abgerufen werden.

Hinweis

Dieser Parameter muss für Windows Phone Silverlight 8.1-Apps URL-codiert sein. Alle anderen App-Typen können eine eigene Struktur verwenden.

square150x150Logo

Uri Uri

Ein Verweis auf ein Mittleres Logo-Bild, das unter einem URI (Uniform Resource Identifier) gespeichert ist. Kann über die SecondaryTileVisualElements.Square150x150Logo-Eigenschaft festgelegt oder abgerufen werden. Dieser Wert kann mithilfe eines der folgenden Schemas ausgedrückt werden: ms-appx:/// A path innerhalb des bereitgestellten App-Pakets. Dieser Pfad wird für Sprachen und DPI-Plateaus aufgelöst, die von der App unterstützt werden.ms-appdata:///local/ A-Datei im Benutzer-App-Speicher gefunden.

desiredSize

TileSize

Die Größe der anzuheftenden Kachel. Dieser Wert muss Standard (das Windows 8-Verhalten bereitstellt), Square150x150 oder Wide310x150 sein. Jeder andere TileSize-Wert bewirkt, dass während der Laufzeit eine Ausnahme ausgelöst wird.

Der DesiredSize-Parameter wird unter Windows Phone 8.1 ignoriert. Auf dem Telefon werden alle Kacheln – einschließlich sekundärer Kacheln – als mittelgroße Kacheln angeheftet, nach denen die Größe vom Benutzer geändert werden kann.

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

Hinweis

Dieser Konstruktor kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Erstellt ein SecondaryTile-Objekt als mittlere Kachel.

Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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)

Parameter

tileId

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die Kachel im App-Paket eindeutig identifiziert. Wählen Sie eine eindeutige ID aus, die für Ihre App aussagekräftig und aussagekräftig ist. Er ist auf 64 Zeichen beschränkt und muss mit einer Zahl oder einem Buchstaben beginnen und aus den Zeichen a-z, A-Z, 0-9, Punkt (.) oder Unterstrich (_) bestehen. Wenn Sie dieselbe ID wie eine vorhandene sekundäre Kachel angeben, wird die vorhandene sekundäre Kachel überschrieben. Kann über die TileId-Eigenschaft festgelegt oder abgerufen werden.

shortName

String

Platform::String

winrt::hstring

Ein Kurzname, der direkt auf der Kachel angezeigt werden soll, wenn die App dies wählt. Alles, was mehr als 40 Zeichen umfasst, wird abgeschnitten. Der Benutzer hat die Möglichkeit, diesen Wert im Rahmen des Anheftungsprozesses zu ändern. Kann über die ShortName-Eigenschaft festgelegt oder abgerufen werden.

Hinweis

Dieser Wert wird nur in Windows 8 verwendet und ist in späteren Versionen zugunsten von displayName veraltet.

displayName

String

Platform::String

winrt::hstring

Ein Name, der auf der Kachel, in der QuickInfo der Kachel und beim Anzeigen kleiner Kacheln angezeigt werden soll, z. B. auf den Bildschirmen "Apps " oder "Suchergebnisse". Diese Zeichenfolge entspricht dem Anzeigenamen, der im Manifest für die Kachel Standard angegeben wird. Es ist auf 256 Zeichen beschränkt, sollte aber in der Praxis kurz gehalten werden, um abgeschnitten zu werden. Dieser Wert kann über die DisplayName-Eigenschaft festgelegt oder abgerufen werden.

Der Anzeigename wird nur auf der breiten sekundären Kachel auf Windows Phone 8.1 angezeigt.

arguments

String

Platform::String

winrt::hstring

Eine von der App definierte Zeichenfolge, die für die aufrufende Anwendung sinnvoll ist. Diese Argumentzeichenfolge wird zurück an die App übergeben, wenn die App von der sekundären Kachel aus aktiviert wird. Sie wird nach 2048 Zeichen abgeschnitten. Kann über die Arguments-Eigenschaft festgelegt oder abgerufen werden.

tileOptions

TileOptions

Ein -Wert, der verschiedene Optionen angibt, z. B. ob der Name auf der sekundären Kachel angezeigt wird. Kann über die TileOptions-Eigenschaft festgelegt oder abgerufen werden.

logoReference

Uri Uri

Ein Verweis auf ein quadratisches Logobild, das unter einem URI (Uniform Resource Identifier) gespeichert ist. Kann über die Logo-Eigenschaft festgelegt oder abgerufen werden. Dieser Wert kann mithilfe eines der folgenden Schemas ausgedrückt werden: ms-appx:/// A path innerhalb des bereitgestellten App-Pakets. Dieser Pfad wird für Sprachen und DPI-Plateaus aufgelöst, die von der App unterstützt werden.ms-appdata:///local/ A-Datei im Benutzer-App-Speicher gefunden.

Attribute

DeprecatedAttribute

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

Hinweis

Dieser Konstruktor kann geändert oder für Releases nach Windows 8.1 nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) und geben Sie andere Kachelgrößen und Optionen über die SecondaryTile.VisualElements-Methode an .

Erstellt ein SecondaryTile-Objekt als breite Kachel.

Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

In Windows Phone 8.1 werden alle Kacheln – einschließlich sekundärer Kacheln – als mittlere Kacheln angeheftet, nach denen die Größe vom Benutzer geändert werden kann. Dieser Konstruktor bietet die Möglichkeit, die Größe in eine breite Kachel zu ändern.

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)

Parameter

tileId

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die Kachel im App-Paket eindeutig identifiziert. Wählen Sie eine eindeutige ID aus, die für Ihre App aussagekräftig und aussagekräftig ist. Er ist auf 64 Zeichen beschränkt und muss mit einer Zahl oder einem Buchstaben beginnen und aus den Zeichen a-z, A-Z, 0-9, Punkt (.) oder Unterstrich (_) bestehen. Wenn Sie dieselbe ID wie eine vorhandene sekundäre Kachel angeben, wird die vorhandene sekundäre Kachel überschrieben. Kann über die TileId-Eigenschaft festgelegt oder abgerufen werden.

shortName

String

Platform::String

winrt::hstring

Ein Kurzname, der direkt auf der Kachel angezeigt werden soll, wenn die App dies wählt. Alles, was mehr als 40 Zeichen umfasst, wird abgeschnitten. Der Benutzer hat die Möglichkeit, diesen Wert im Rahmen des Anheftungsprozesses zu ändern. Kann über die ShortName-Eigenschaft festgelegt oder abgerufen werden.

Hinweis

Dieser Wert wird nur in Windows 8 verwendet und ist in späteren Versionen zugunsten von displayName veraltet.

displayName

String

Platform::String

winrt::hstring

Ein Name, der auf der Kachel, in der QuickInfo der Kachel und beim Anzeigen kleiner Kacheln angezeigt werden soll, z. B. auf den Bildschirmen "Apps " oder "Suchergebnisse". Diese Zeichenfolge entspricht dem Anzeigenamen, der im Manifest für die Kachel Standard angegeben wird. Es ist auf 256 Zeichen beschränkt, sollte aber in der Praxis kurz gehalten werden, um abgeschnitten zu werden. Dieser Wert kann über die DisplayName-Eigenschaft festgelegt oder abgerufen werden.

Der Anzeigename wird nur auf der breiten sekundären Kachel auf Windows Phone 8.1 angezeigt.

arguments

String

Platform::String

winrt::hstring

Eine von der App definierte Zeichenfolge, die für die aufrufende Anwendung sinnvoll ist. Diese Argumentzeichenfolge wird zurück an die App übergeben, wenn die App von der sekundären Kachel aus aktiviert wird. Sie wird nach 2048 Zeichen abgeschnitten. Kann über die Arguments-Eigenschaft festgelegt oder abgerufen werden.

tileOptions

TileOptions

Ein -Wert, der verschiedene Optionen angibt, z. B. ob der Name auf der sekundären Kachel angezeigt wird. Kann über die TileOptions-Eigenschaft festgelegt oder abgerufen werden.

logoReference

Uri Uri

Ein Verweis auf ein Mittleres Logo-Bild, das unter einem URI (Uniform Resource Identifier) gespeichert ist. Kann über die Square150x150Logo-Eigenschaft festgelegt oder abgerufen werden. Dieser Wert kann mithilfe eines der folgenden Schemas ausgedrückt werden: ms-appx:/// A path innerhalb des bereitgestellten App-Pakets. Dieser Pfad wird für Sprachen und DPI-Plateaus aufgelöst, die von der App unterstützt werden.ms-appdata:///local/ A-Datei im Benutzer-App-Speicher gefunden.

wideLogoReference

Uri Uri

Ein Verweis auf ein breites Logobild, das unter einem URI (Uniform Resource Identifier) gespeichert ist. Kann über die WideLogo-Eigenschaft festgelegt oder abgerufen werden. Dieser Wert kann mithilfe eines der folgenden Schemas ausgedrückt werden: ms-appx:/// A path innerhalb des bereitgestellten App-Pakets. Dieser Pfad wird für Sprachen und DPI-Plateaus aufgelöst, die von der App unterstützt werden.ms-appdata:///local/ A-Datei im Benutzer-App-Speicher gefunden.

Attribute

DeprecatedAttribute