PipsPager Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Steuerelement dar, das die Navigation in linear paginierten Inhalten mithilfe einer konfigurierbaren Sammlung von Glyphen ermöglicht, die jeweils eine einzelne "Seite" innerhalb eines unbegrenzten Bereichs darstellen.
Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PipsPager : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class PipsPager : Control
Public Class PipsPager
Inherits Control
- Vererbung
-
PipsPager
- Attribute
-
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Beispiele
Tipp
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter PipsPager.
Die WinUI 3-Katalog- und WinUI 2-Katalog-Apps umfassen interaktive Beispiele für die meisten WinUI 3- und WinUI 2-Steuerelemente, -Features und -Funktionen.
Wenn sie bereits installiert sind, öffnen Sie sie, indem Sie auf die folgenden Links klicken: WinUI 3-Katalog oder WinUI 2-Katalog.
Wenn sie nicht installiert sind, können Sie den WinUI 3-Katalog und den WinUI 2-Katalog aus dem Microsoft Store herunterladen.
Sie können auch den Quellcode für beide von GitHub abrufen (verwenden Sie denmain-Branch für WinUI 3 und den Branchwinui2 für WinUI 2).
Tipp
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter PipsPager.
Die App WinUI 2-Katalog umfasst interaktive Beispiele für die meisten WinUI 2-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.
Hinweise
Die Glyphen heben die aktuelle Seite hervor und geben die Verfügbarkeit von vorangehenden und nachfolgenden Seiten an. Das Steuerelement basiert auf dem aktuellen Kontext und unterstützt keine explizite Seitennummerierung oder eine nicht lineare Organisation.
Weitere Informationen finden Sie in der PipsPager-Übersicht .
Steuerelementstil und -vorlage
Sie können den Standardstil und die ControlTemplate ändern, um dem Steuerelement ein eindeutiges Erscheinungsbild zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. Der Standardstil, die Vorlage und die Ressourcen, die das Erscheinungsbild des Steuerelements definieren, sind in der generic.xaml
Datei enthalten. Zu Entwurfszwecken generic.xaml
wird mit dem NuGet-Paket WinUI (Microsoft.UI.Xaml) installiert. Standardmäßig ist der Speicherort \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml
. Stile und Ressourcen aus verschiedenen WinUI-Versionen können unterschiedliche Werte aufweisen.
XAML enthält auch Ressourcen, mit denen Sie die Farben eines Steuerelements in verschiedenen visuellen Zuständen ändern können, ohne die Steuerelementvorlage zu ändern. Das Ändern dieser Ressourcen wird bevorzugt, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Formatvorlagen .
Konstruktoren
PipsPager() |
Initialisiert eine neue instance der PipsPager-Klasse. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
Eigenschaften
MaxVisiblePips |
Die maximale Anzahl von Pips, die gleichzeitig im PipsPager angezeigt werden. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
MaxVisiblePipsProperty |
Identifiziert die MaxVisiblePips-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NextButtonStyle |
Ruft die Formatvorlage ab, die auf die Schaltfläche Weiter angewendet werden soll, oder legt sie fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NextButtonStyleProperty |
Identifiziert die NextButtonStyle-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NextButtonVisibility |
Ruft den Anzeigezustand der Schaltfläche Weiter ab oder legt den Anzeigezustand fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NextButtonVisibilityProperty |
Identifiziert die NextButtonVisibility-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NormalPipStyle |
Ruft die Formatvorlage für die standardmäßigen, nicht ausgewählten Pips im PipsPager ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NormalPipStyleProperty |
Identifiziert die NormalPipStyle-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NumberOfPages |
Ruft die maximale Anzahl von Seiten ab, die vom PipsPager unterstützt werden, oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
NumberOfPagesProperty |
Identifiziert die NumberOfPages-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
Orientation |
Ruft die Ausrichtung der Pips und Navigationsschaltflächen im PipsPager ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
OrientationProperty |
Identifiziert die Orientation-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
PreviousButtonStyle |
Ruft die Formatvorlage ab, die auf die Schaltfläche Zurück angewendet werden soll, oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
PreviousButtonStyleProperty |
Identifiziert die PreviousButtonStyle-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
PreviousButtonVisibility |
Ruft den Anzeigezustand der Schaltfläche Zurück ab oder legt den Anzeigezustand fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
PreviousButtonVisibilityProperty |
Identifiziert die PreviousButtonVisibility-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
SelectedPageIndex |
Ruft den 0-basierten Index des aktuell ausgewählten Pips in PipsPager ab oder legt den 0-basierten Index fest. Ein Pip ist immer ausgewählt. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
SelectedPageIndexProperty |
Identifiziert die SelectedPageIndex-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
SelectedPipStyle |
Ruft die Formatvorlage ab, die auf das ausgewählte pip im PipsPager angewendet werden soll, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
SelectedPipStyleProperty |
Gibt die SelectedPipStyle-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
TemplateSettings |
Stellt berechnete Werte bereit, auf die beim Definieren von Vorlagen für einen PipsPager als TemplatedParent-Quellen verwiesen werden kann. Nicht für den allgemeinen Gebrauch vorgesehen. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
Ereignisse
SelectedIndexChanged |
Tritt auf, nachdem sich der ausgewählte Index auf dem PipsPager geändert hat. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |