Xamarin.Forms Ansichten

Beispiel herunterladen Herunterladen des Beispiels

Xamarin.Forms Ansichten sind die Bausteine plattformübergreifender mobiler Benutzeroberflächen.

Ansichten sind Benutzeroberflächenobjekte wie Bezeichnungen, Schaltflächen und Schieberegler, die häufig als Steuerelemente oder Widgets in anderen grafischen Programmierumgebungen bekannt sind. Die von allen unterstützten Xamarin.Forms Ansichten werden von der View Klasse abgeleitet. Sie können in mehrere Kategorien unterteilt werden:

Ansichten für die Präsentation

type BESCHREIBUNG Darstellung
BoxView BoxView zeigt ein durch die Color Eigenschaft farbiges Rechteck an. BoxView hat eine Standardgrößeanforderung von 40x40. Weisen Sie für andere Größen die WidthRequest eigenschaften zu HeightRequest .

API-Dokumentation / Anleitung / Beispiel 1, 2, 3, 4, 5 und 6
BoxView()
C#-Code für diese Seite / XAML-Seite
Ellipse Ellipse zeigt eine Auslassungspunkte oder einen Kreis der Größe WidthRequest x HeightRequestan. Um die Innenseite der Auslassungspunkte zu zeichnen, legen Sie die Fill Eigenschaft auf eine Color. Um der Ellipse eine Gliederung zu geben, legen Sie dessen Stroke Eigenschaft auf eine Color.

API-Dokumentation / Anleitung / Beispiel
Ellipse(Beispiel)
C#-Code für diese Seite / XAML-Seite
Label Label Zeigt einzeilige Textzeichenfolgen oder mehrzeilige Textblöcke an, entweder mit Konstanten- oder Variablenformatierung. Legen Sie die Text Eigenschaft auf eine Zeichenfolge für die Konstantenformatierung fest, oder legen Sie die Eigenschaft auf ein FormattedString Objekt für die FormattedText Variablenformatierung fest.

API-Dokumentation / Anleitung / Beispiel
Bezeichnungsbezeichnung
C#-Code für diese Seite / XAML-Seite
Line Line zeigt eine Linie von einem Anfangspunkt zu einem Endpunkt an. Der Anfangspunkt wird durch die X1 und Y1 die Eigenschaften dargestellt, während der Endpunkt durch die und Y2 die X2 Eigenschaften dargestellt wird. Um die Linie zu farben, legen Sie die Stroke Eigenschaft auf eine Color.

API-Dokumentation / Anleitung / Beispiel
für Linienlinien (Beispiel)
C#-Code für diese Seite / XAML-Seite
Image Image zeigt eine Bitmap an. Bitmaps können über das Web heruntergeladen werden, eingebettet als Ressourcen in den allgemeinen Projekt- oder Plattformprojekten oder mithilfe eines .NET-Objekts Stream erstellt werden.

API-Dokumentation / Anleitung / Beispiel
Beispielbild (
C#-Code für diese Seite / XAML-Seite
Map Map zeigt eine Karte an. Die Xamarin.Forms. Das NuGet-Paket "Karten " muss installiert werden. Android und Universelle Windows-Plattform erfordern einen Kartenautorisierungsschlüssel.

API-Dokumentation / Anleitung / Beispiel
für kartenzuordnung (Beispielbeispiel)
C#-Code für diese Seite / XAML-Seite
OpenGLView OpenGLView Zeigt OpenGL-Grafiken in iOS- und Android-Projekten an. Es gibt keine Unterstützung für die Universelle Windows-Plattform. Die iOS- und Android-Projekte erfordern einen Verweis auf die OpenTK-1.0-Assembly oder die OpenTK Version 1.0.0.0-Assembly. OpenGLView ist einfacher in einem freigegebenen Projekt zu verwenden; wenn sie in einer .NET Standardbibliothek verwendet wird, ist auch ein Abhängigkeitsdienst erforderlich (wie im Beispielcode dargestellt).

Dies ist die einzige Grafikeinrichtung, die integriert Xamarin.Formsist, aber eine Xamarin.Forms Anwendung kann Grafiken auch mithilfe SkiaSharpvon , oder UrhoSharp.

API-Dokumentation

OpenGLView-Beispiel für OpenGLView-Beispiel für
C#-Code für diese Seite / XAML-Seite mit CodeBehind
Path Path Zeigt Kurven und komplexe Formen an. Die Data Eigenschaft gibt die form an, die gezeichnet werden soll. Um die Form zu farben, legen Sie die Stroke Eigenschaft auf eine Color.

API-Dokumentation / Anleitung / Beispiel
für Pfadpfad(n)
C#-Code für diese Seite / XAML-Seite
Polygon Polygon zeigt ein Polygon an. Die Points Eigenschaft gibt die Vertexpunkte des Polygons an, während die FillRule Eigenschaft angibt, wie die Innenfüllung des Polygons bestimmt wird. Um die Innenseite des Polygons zu zeichnen, legen Sie seine Fill Eigenschaft auf ein Color. Um dem Polygon eine Gliederung zu geben, legen Sie dessen Stroke Eigenschaft auf eine Color.

API-Dokumentation / Anleitung / Beispiel
Polygon-Beispiel-Polygon
C#-Code für diese Seite / XAML-Seite
Polyline Polyline zeigt eine Reihe verbundener gerader Linien an. Die Points Eigenschaft gibt die Vertexpunkte der Polylinie an, während die FillRule Eigenschaft angibt, wie die Innenfüllung der Polylinie bestimmt wird. Um die Innenseite der Polylinie zu zeichnen, legen Sie seine Fill Eigenschaft auf eine Color. Um der Polylinie eine Gliederung zu geben, legen Sie seine Stroke Eigenschaft auf eine Color.

API-Dokumentation / Anleitung / Beispiel
für Polyline()
C#-Code für diese Seite / XAML-Seite
Rectangle Rectangle zeigt ein Rechteck oder ein Quadrat an. Um die Innenseite des Rechtecks zu zeichnen, legen Sie die Fill Eigenschaft auf eine Color. Um dem Rechteck eine Gliederung zu geben, legen Sie dessen Stroke Eigenschaft auf eine Color.

API-Dokumentation / Anleitung / Beispiel
Rechteck-Beispiel-Beispielrechteck (Beispielbeispiel)
C#-Code für diese Seite / XAML-Seite
WebView WebViewzeigt Webseiten oder HTML-Inhalte an, basierend darauf, ob die Source Eigenschaft auf ein oder ein HtmlWebViewSourceUriWebViewSource Objekt festgelegt ist.

API-Dokumentation / Anleitung / Beispiel 1 und 2
für WebView(Beispiel)
C#-Code für diese Seite / XAML-Seite

Ansichten, die Befehle initiieren

type BESCHREIBUNG Darstellung
Button Button ist ein rechteckiges Objekt, das Text anzeigt und ein Clicked Ereignis auslöst, wenn es gedrückt wird.

API-Dokumentation / Anleitung / Beispiel
für schaltflächenschaltfläche (Beispiel)
C#-Code für diese Seite / XAML-Seite mit CodeBehind
ImageButton ImageButton ist ein rechteckiges Clicked Objekt, das ein Bild anzeigt und ein Ereignis auslöst, wenn es gedrückt wird.

API-Dokumentation / Anleitung / Beispiel

C#-Code für diese Seite / XAML-Seite mit CodeBehind
RadioButton RadioButton ermöglicht die Auswahl einer Option aus einer Gruppe und löst ein CheckedChanged Ereignis aus, wenn die Auswahl auftritt.

API-Dokumentation / Anleitung / Beispiel
für RadioButton(Beispiel)
C#-Code für diese Seite / XAML-Seite mit CodeBehind
RefreshView RefreshView ist ein Containersteuerelement, das Pull-to-Refresh-Funktionen für scrollbare Inhalte bereitstellt. Die ICommand durch die Command Eigenschaft definierte Eigenschaft wird ausgeführt, wenn eine Aktualisierung ausgelöst wird, und die IsRefreshing Eigenschaft gibt den aktuellen Status des Steuerelements an.

API-Dokumentation / Anleitung / Beispiel
) für RefreshView
C#-Code für diese Seite / XAML-Seite mit CodeBehind
SearchBar SearchBar zeigt einen Bereich an, in den der Benutzer eine Textzeichenfolge eingeben soll, und eine Schaltfläche (oder eine Tastaturtaste), die die Anwendung angibt, um eine Suche auszuführen. Die Text Eigenschaft bietet Zugriff auf den Text, und das SearchButtonPressed Ereignis gibt an, dass die Schaltfläche gedrückt wurde.

API-Dokumentation / Anleitung / Beispiel
für suchleisten-Beispiel für Suchleisten
C#-Code für diese Seite / XAML-Seite mit CodeBehind
SwipeView SwipeView ist ein Containersteuerelement, das ein Element des Inhalts umschließt, und stellt Kontextmenüelemente bereit, die durch eine Wischbewegung angezeigt werden. Jedes Menüelement wird durch ein SwipeItemMenüelement dargestellt, das über eine Command Eigenschaft verfügt, die ein ICommand Element ausführt, wenn auf das Element gekippt wird.

API-Dokumentation / Anleitung / Beispiel
SwipeView-Beispiel für Wischansicht(Beispiel) wischview
C#-Code für diese Seite / XAML-Seite mit CodeBehind

Ansichten zum Festlegen von Werten

type BESCHREIBUNG Darstellung
CheckBox CheckBox Ermöglicht dem Benutzer, einen booleschen Wert mithilfe eines Typs von Schaltflächen auszuwählen, der entweder aktiviert oder leer sein kann. Die IsChecked Eigenschaft ist der Status des CheckBox, und das Ereignis wird ausgelöst, wenn sich der CheckedChanged Zustand ändert.

API-Dokumentation / Anleitung / Beispiel
CheckBox-Beispiel für CheckBox-Beispiel für CheckBox
C#-Code für diese Seite / XAML-Seite
Slider Slider Ermöglicht dem Benutzer, einen double Wert aus einem fortlaufenden Bereich auszuwählen, der mit den Minimum Eigenschaften angegeben ist Maximum .

API-Dokumentation / Anleitung / Beispiel
für Schieberegler(Schieberegler)
C#-Code für diese Seite / XAML-Seite
Stepper StepperErmöglicht dem Benutzer, einen double Wert aus einem Bereich von inkrementellen Werten auszuwählen, die mit den Eigenschaften Maximum, und Increment den MinimumEigenschaften angegeben sind.

API-Dokumentation / Anleitung / Beispiel
für Schrittschritte() (Beispiel)
C#-Code für diese Seite / XAML-Seite
Switch Switch verwendet die Form eines Ein/Aus-Schalters, damit der Benutzer einen booleschen Wert auswählen kann. Die IsToggled Eigenschaft ist der Status des Schalters, und das Toggled Ereignis wird ausgelöst, wenn sich der Zustand ändert.

API-Dokumentation / Anleitung / Beispiel
für Switch-Beispielschalter
C#-Code für diese Seite / XAML-Seite
DatePicker DatePicker Ermöglicht dem Benutzer, ein Datum mit der Plattformdatumsauswahl auszuwählen. Legen Sie einen Bereich zulässiger Datumsangaben mit den MinimumDate eigenschaften fest MaximumDate . Die Date Eigenschaft ist das ausgewählte Datum, und das DateSelected Ereignis wird ausgelöst, wenn diese Eigenschaft geändert wird.

API-Dokumentation / Anleitung / Beispiel
für DatePicker-Beispiel"
C#-Code für diese Seite / XAML-Seite
TimePicker TimePicker ermöglicht dem Benutzer, eine Zeit mit der Plattformzeitauswahl auszuwählen. Die Time Eigenschaft ist die ausgewählte Uhrzeit. Eine Anwendung kann Änderungen in der Time Eigenschaft überwachen, indem Sie einen Handler für das PropertyChanged Ereignis installieren.

API-Dokumentation / Anleitung / Beispiel
für TimePicker-Beispiel für TimePicker
C#-Code für diese Seite / XAML-Seite

Ansichten zum Bearbeiten von Text

Diese beiden Klassen werden von der InputView Klasse abgeleitet, die die Keyboard Eigenschaft definiert:

type BESCHREIBUNG Darstellung
Entry Entry Ermöglicht dem Benutzer, eine einzelne Textzeile einzugeben und zu bearbeiten. Der Text ist als Text Eigenschaft verfügbar, und die TextChanged Ereignisse werden Completed ausgelöst, wenn sich der Text ändert oder der Benutzer die Fertigstellung signalisiert, indem er auf die EINGABETASTE tippt.

Verwenden Sie eine Editor Zum Eingeben und Bearbeiten mehrerer Textzeilen.

API-Dokumentation / Anleitung / Beispiel
für eintragsbeispiele
C#-Code für diese Seite / XAML-Seite
Editor Editor Ermöglicht dem Benutzer, mehrere Textzeilen einzugeben und zu bearbeiten. Der Text ist als Text Eigenschaft verfügbar, und die TextChanged Ereignisse Completed werden ausgelöst, wenn sich der Text ändert oder der Benutzer die Fertigstellung signalisiert.

Verwenden Sie eine Ansicht zum Eingeben und Bearbeiten einer Entry einzelnen Textzeile.

API-Dokumentation / Anleitung / Beispiel
für Editor-Beispiel-Editor
C#-Code für diese Seite / XAML-Seite

Ansichten zum Anzeigen einer Aktivität

type BESCHREIBUNG Darstellung
ActivityIndicator ActivityIndicator verwendet eine Animation, um zu zeigen, dass die Anwendung in einer langen Aktivität beschäftigt ist, ohne einen Hinweis auf den Fortschritt zu geben. Die IsRunning Eigenschaft steuert die Animation.

Wenn der Fortschritt der Aktivität bekannt ist, verwenden Sie stattdessen eine ProgressBar .

API-Dokumentation / Anleitung / Beispiel
ActivityIndicator Example ActivityIndicator
C#-Code für diese Seite / XAML-Seite
ProgressBar ProgressBar verwendet eine Animation, um anzuzeigen, dass die Anwendung durch eine lange Aktivität fortschreitet. Legen Sie die Progress Eigenschaft auf Werte zwischen 0 und 1 fest, um den Fortschritt anzugeben.

Wenn der Fortschritt der Aktivität nicht bekannt ist, verwenden Sie stattdessen eine ActivityIndicator .

API-Dokumentation / Anleitung / Beispiel
)
C#-Code für diese Seite / XAML-Seite mit CodeBehind

Ansichten, die Sammlungen anzeigen

type BESCHREIBUNG Darstellung
CarouselView CarouselView zeigt eine bildlauffähige Liste von Datenelementen an. Legen Sie die ItemsSource Eigenschaft auf eine Auflistung von Objekten fest, und legen Sie die ItemTemplate Eigenschaft auf ein DataTemplate Objekt fest, das beschreibt, wie die Elemente formatiert werden sollen. Das CurrentItemChanged Ereignis signalisiert, dass sich das aktuell angezeigte Element geändert hat, das als CurrentItem Eigenschaft verfügbar ist.

Anleitung / Beispiel
(CarouselView-Beispiel)
C#-Code für diese Seite / XAML-Seite
CollectionView CollectionView zeigt eine bildlauffähige Liste der auswählbaren Datenelemente mit unterschiedlichen Layoutspezifikationen an. Ziel ist es, eine flexiblere und leistungsfähigere Alternative zu ListViewbieten. Legen Sie die ItemsSource Eigenschaft auf eine Auflistung von Objekten fest, und legen Sie die ItemTemplate Eigenschaft auf ein DataTemplate Objekt fest, das beschreibt, wie die Elemente formatiert werden sollen. Das SelectionChanged Ereignis signalisiert, dass eine Auswahl vorgenommen wurde, die als SelectedItem Eigenschaft verfügbar ist.

Anleitung / Beispiel
CollectionView-Beispiel für CollectionView
C#-Code für diese Seite / XAML-Seite
IndicatorView IndicatorViewzeigt Indikatoren an, die die Anzahl der Elemente in einem .CarouselView Legen Sie die CarouselView.IndicatorView Eigenschaft auf das IndicatorView Objekt fest, um Indikatoren für die CarouselView.

API-Dokumentation / Anleitung / Beispiel

C#-Code für diese Seite / XAML-Seite
ListView ListView abgeleitet von ItemsView und zeigt eine bildlauffähige Liste der auswählbaren Datenelemente an. Legen Sie die ItemsSource Eigenschaft auf eine Auflistung von Objekten fest, und legen Sie die ItemTemplate Eigenschaft auf ein DataTemplate Objekt fest, das beschreibt, wie die Elemente formatiert werden sollen. Das ItemSelected Ereignis signalisiert, dass eine Auswahl vorgenommen wurde, die als SelectedItem Eigenschaft verfügbar ist.

API-Dokumentation / Anleitung / Beispiel
ListView-Beispiel
C#-Code für diese Seite / XAML-Seite
Picker Picker zeigt ein ausgewähltes Element aus einer Liste von Textzeichenfolgen an und ermöglicht das Auswählen dieses Elements, wenn die Ansicht angetippt wird. Legen Sie die Items Eigenschaft auf eine Liste von Zeichenfolgen oder die ItemsSource Eigenschaft auf eine Auflistung von Objekten fest. Das SelectedIndexChanged Ereignis wird ausgelöst, wenn ein Element ausgewählt ist.

Die Picker Liste der Elemente wird nur angezeigt, wenn sie ausgewählt ist. Verwenden Sie eine ListView oder TableView eine bildlauffähige Liste, die auf der Seite verbleibt.

API-Dokumentation / Anleitung
Picker-Beispielauswahl (Beispielbeispiel)
C#-Code für diese Seite / XAML-Seite mit CodeBehind
TableView TableView zeigt eine Liste der Zeilen des Typs Cell mit optionalen Kopfzeilen und Unterüberschriften an. Legen Sie die Root Eigenschaft auf ein Objekt vom Typ TableRootfest, und fügen Sie dieser TableRootObjekte hinzuTableSection. Jede TableSection ist eine Auflistung von Cell Objekten.

API-Dokumentation / Anleitung / Beispiel

C#-Code für diese Seite / XAML-Seite