Arbeiten mit tvOS-Statusindikatoren in Xamarin
Dieser Artikel behandelt das Entwerfen und Arbeiten mit Statusindikatoren innerhalb einer Xamarin.tvOS-App.
Es kann vorkommen, dass Ihre Xamarin.tvOS-App neue Inhalte laden muss oder einen langwierigen Verarbeitungsvorgang ausführt. In diesen Zeiten sollten Sie entweder eine Aktivitätsanzeige oder eine Statusanzeige präsentieren, um dem Benutzer mitzuteilen, dass die App noch ausgeführt wird, und um ihnen einen Hinweis auf die Dauer der Ausführung der Aufgabe zu geben.
Informationen zu Aktivitätsindikatoren
Ein Aktivitätsindikator stellt eine sich drehende Kog dar und wird verwendet, um eine Aufgabe einer unbestimmten Länge darzustellen. Der Indikator wird angezeigt, wenn die Aufgabe gestartet und ausgeblendet wird, wenn die Aufgabe abgeschlossen ist.
Apple hat die folgenden Vorschläge für das Arbeiten mit Aktivitätsindikatoren:
- Verwenden Sie stattdessen fortschrittsleisten – Da ein Aktivitätsindikator dem Benutzer kein Feedback gibt, wie lange der Prozess ausgeführt wird, verwenden Sie immer eine Statusanzeige, wenn die Länge bekannt ist (z. B. wie viele Bytes in eine Datei heruntergeladen werden sollen).
- Halten Sie den Indikator animiert – Benutzer beziehen einen stationären Aktivitätsindikator auf eine feststehende App, sodass Sie den Indikator immer animieren sollten, während er angezeigt wird.
- Beschreiben Sie die verarbeitete Aufgabe– Das Anzeigen des Aktivitätsindikators allein reicht nicht aus; der Benutzer muss über den Prozess informiert werden, auf dem sie warten. Fügen Sie eine aussagekräftige Bezeichnung (in der Regel einen einzelnen, vollständigen Satz) hinzu, der die Aufgabe eindeutig definiert.
Informationen zu Statusanzeigen
Eine Statusanzeige wird als Linie dargestellt, die mit Farbe gefüllt wird, um den Zustand und die Länge eines zeitaufwendigen Vorgangs anzugeben. Statusindikatoren sollten immer verwendet werden, wenn die Länge der Vorgänge bekannt ist oder berechnet werden kann.
Apple hat die folgenden Vorschläge für die Arbeit mit Statusanzeigen:
- Genaues Melden des Fortschritts – Statusanzeigen sollten immer eine genaue Darstellung der Zeit darstellen, die zum Abschließen einer Aufgabe erforderlich ist. Stellen Sie niemals die Zeit falsch dar, um die App ausgelastet zu machen.
- Verwendung für gut definierte Dauer – Statusanzeigen sollten nicht nur zeigen, dass eine langwierige Aufgabe stattfindet, sondern dem Benutzer und den Hinweis darauf geben, wie viel der Vorgang abgeschlossen ist, und eine Schätzung der Zeitumstellung Standard.
Statusindikatoren und Storyboards
Die einfachste Möglichkeit zum Arbeiten mit einer Statusanzeige in einer Xamarin.tvOS-App besteht darin, sie mithilfe des iOS-Designers zur Benutzeroberfläche der App hinzuzufügen.
Doppelklicken Sie auf dem Lösungspad auf die Datei "Main.storyboard", und öffnen Sie sie zur Bearbeitung.
Ziehen Sie einen Aktivitätsindikator aus der Toolbox , und legen Sie ihn in der Ansicht ab:
Auf der Registerkarte "Widget" des Eigenschaftenblocks können Sie mehrere Eigenschaften des Aktivitätsindikators anpassen, z. B. " Stil", "Verhalten" und "Name":
Der Name bestimmt den Namen der Eigenschaft, die den Aktivitätsindikator im C#-Code darstellt.
Ziehen Sie eine Statusansicht aus der Toolbox , und legen Sie sie in der Ansicht ab:
Auf der Registerkarte "Widget" des Eigenschaften-Explorers können Sie verschiedene Eigenschaften der Statusansicht anpassen, z. B. " Formatvorlage", "Fortschritt" (Prozent abgeschlossen) und "Name":
Der Name bestimmt den Namen der Eigenschaft, die die Statusansicht im C#-Code darstellt.
Speichern Sie die Änderungen.
Weitere Informationen zum Arbeiten mit Storyboards finden Sie in unserem Schnellstarthandbuch für Hello, tvOS.
Arbeiten mit Aktivitätsindikatoren
Wie oben erwähnt, sollten Aktivitätsindikatoren angezeigt werden, wenn Ihre App einen langen Prozess unbestimmter Länge ausführt.
An jedem Punkt können Sie sehen, ob ein Aktivitätsindikator animiert wird, indem Sie seine IsAnimating Eigenschaft überprüfen. Wenn die HidesWhenStopped Eigenschaft lautet true, wird der Aktivitätsindikator automatisch ausgeblendet, wenn die Animation beendet wird.
Sie können den folgenden Code verwenden, um die Animation zu starten:
ActivityIndicator.StartAnimating();
Und die Animation wird wie folgt beendet:
ActivityIndicator.StopAnimating();
Hinweis
Bei diesen Codeausschnitten wird davon ausgegangen, dass der Name des Aktivitätsindikators auf "ActivityIndicator" auf der Registerkarte "Widget" des iOS-Designers festgelegt wurde.
Arbeiten mit Statusanzeigen
Auch hier sollte jederzeit eine Statusanzeige verwendet werden, wenn Ihre App eine lange ausgeführte Aufgabe einer bekannten Dauer ausführt.
Die Progress Eigenschaft wird verwendet, um den Betrag des Vorgangs festzulegen, der von 0 % auf 100 % abgeschlossen wurde (0,0 bis 1,0). Verwenden Sie die ProgressTintColor Eigenschaft, um die Farbe des abgeschlossenen Balkens für die Menge und die TrackTintColor Eigenschaft festzulegen, um die Hintergrundfarbe (nicht abgeschlossene Menge) festzulegen.
Zusammenfassung
In diesem Artikel wurde das Entwerfen und Arbeiten mit Statusindikatoren in einer Xamarin.tvOS-App behandelt.