Xamarin.Forms Zobrazení

Stáhnout ukázku Stažení ukázky

Zobrazení jsou stavebními bloky mobilních uživatelských rozhraní pro více platforem.

Zobrazení jsou objekty uživatelského rozhraní, jako jsou popisky, tlačítka a posuvníky, které se v jiných grafických programovacích prostředích běžně označované jako ovládací prvky nebo pomůcky. Zobrazení podporovaná Xamarin.Forms všemi View třídami jsou odvozena. Lze je rozdělit do několika kategorií:

Zobrazení pro prezentaci

Typ Description Vzhled
BoxView BoxViewzobrazí plný obdélník, který má Xamarin_Forms BoxView _BoxView_Color" data-linktype="absolute-path">Color vlastnost. BoxView má požadavek na výchozí velikost 40 × 40. Pro jiné velikosti přiřaďte Xamarin_Forms _VisualElement_WidthRequest" data-linktype="absolute-path">a WidthRequest Xamarin_Forms WidthRequest _VisualElement_HeightRequest" data-linktype="absolute-path">HeightRequest vlastnosti.

Dokumentace k rozhraní API PrůvodceUkázka 1,2,3,4,5a 6
Example BoxView Example
Kód jazyka C# pro tuto stránkuStránka XAML
Ellipse Ellipsezobrazí tři tečky nebo kruh o velikosti Xamarin_Forms Ellipse _VisualElement_WidthRequest" data-linktype="absolute-path">WidthRequest x Xamarin_Forms _VisualElement_HeightRequest" data-linktype="absolute-path">HeightRequest . Pokud chcete vykreslit vnitřní tři tečky, nastavte její Xamarin_Forms _Shapes_Shape_Fill" data-linktype="absolute-path">Fill vlastnost na Color . Pokud chcete dát tři tečky obrysu, nastavte jeho Xamarin_Forms _Shapes_Shape_Stroke" data-linktype="absolute-path">Stroke vlastnost na Color .

Dokumentace k rozhraní API PrůvodceUkázka
příklad elipsy
Kód jazyka C# pro tuto stránkuStránka XAML
Label Label zobrazí jednořádkové textové řetězce nebo víceřádkové bloky textu s konstantním nebo proměnlivým formátováním. Nastavte vlastnost Xamarin_Forms _Label_Text" data-linktype="absolute-path">na řetězec pro konstantní formátování nebo nastavte vlastnost Text Xamarin_Forms Text _Label_FormattedText" data-linktype="absolute-path">FormattedText na objekt pro formátování FormattedString proměnných.

Dokumentace k rozhraní API PrůvodceUkázka
příkladu popisku
Kód jazyka C# pro tuto stránkuStránka XAML
Line Line zobrazí čáru od počátečního bodu ke koncovému bodu. Počáteční bod je reprezentován Xamarin_Forms _Shapes_Line_X1" data-linktype="absolutní_cesta">a X1 Xamarin_Forms X1 _Shapes_Line_Y1" data-linktype="absolutní_cesta">vlastnosti. zatímco koncový bod je Y1 reprezentován Xamarin_Forms _Shapes_Line_X2" data-linktype="absolutní_cesta">X2 a Xamarin_Forms _Shapes_Line_Y2" data-linktype="absolutní_cesta">Y2 vlastnosti. Pokud chcete čáru vybarvovat, nastavte její Xamarin_Forms _Shapes_Shape_Stroke" data-linktype="absolute-path">Stroke vlastnost na Color .

Dokumentace k rozhraní API PrůvodceUkázka
příkladu
Kód jazyka C# pro tuto stránkuStránka XAML
Image Image zobrazí rastrový obrázek. Rastrové obrázky lze stáhnout přes web, vložit jako prostředky do společného projektu nebo projektu platformy nebo vytvořit pomocí objektu Stream .NET.

Dokumentace k rozhraní API PrůvodceUkázka
s příkladem
Kód jazyka C# pro tuto stránkuStránka XAML
Map Map zobrazí mapu. Musí být Mapy NuGet .NuGet. Android a Univerzální Windows Platform vyžadují autorizační klíč mapy.

Dokumentace k rozhraní API PrůvodceUkázka
příkladu
Kód jazyka C# pro tuto stránkuStránka XAML
OpenGLView OpenGLView zobrazí grafiku OpenGL v projektech pro iOS a Android. Univerzální platforma pro Windows platformy neexistuje. Projekty pro iOS a Android vyžadují odkaz na sestavení OpenTK-1.0 nebo na sestavení OpenTK verze 1.0.0.0. OpenGLViewse snadněji používá ve sdíleném Project. Pokud se používá v knihovně .NET Standard, bude také potřeba služba závislostí (jak je znázorněno v ukázkovém kódu).

Jedná se o jediné grafické zařízení, které je součástí , ale aplikace může také vykreslit grafiku Xamarin.FormsXamarin.Forms pomocí , nebo SkiaSharpUrhoSharp .

Dokumentace k rozhraní API

– příklad OpenGLView – příklad
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí
Path Path zobrazuje křivky a složité tvary. Vlastnost Xamarin_Forms _Shapes_Path_Data" data-linktype="absolute-path">určuje tvar, který Data se má nakreslit. Pokud chcete tvar vybarvovat, nastavte jeho Xamarin_Forms _Shapes_Shape_Stroke" data-linktype="absolute-path">Stroke vlastnost na Color .

Dokumentace k rozhraní API PrůvodceUkázka
v příkladu
Kód jazyka C# pro tuto stránkuStránka XAML
Polygon Polygon zobrazí mnohoúhelník. Vlastnost Xamarin_Forms _Shapes_Polygon_Points" data-linktype="absolute-path">určuje body vrcholu mnohoúhelníku, zatímco vlastnost Points Xamarin_Forms Points _Shapes_Polygon_FillRule" data-linktype="absolute-path">FillRule určuje, jak je určena vnitřní výplň mnohoúhelníku. Pokud chcete vykreslit vnitřní část mnohoúhelníku, nastavte její Xamarin_Forms _Shapes_Shape_Fill" data-linktype="absolute-path">Fill vlastnost na Color . Pokud chcete mnohoúhelníku poskytnout obrys, nastavte jeho Xamarin_Forms _Shapes_Shape_Stroke" data-linktype="absolutní_cesta">Stroke vlastnost na Color .

Dokumentace k rozhraní API PrůvodceUkázka
– příklad mnohoúhelníku
Kód jazyka C# pro tuto stránkuStránka XAML
Polyline Polyline zobrazí řadu propojených přímek. Vlastnost Xamarin_Forms _Shapes_Polygon_Points" data-linktype="absolute-path">určuje body vrcholu line, zatímco vlastnost Points Xamarin_Forms Points _Shapes_Polygon_FillRule" data-linktype="absolute-path">FillRule určuje, jak se určí vnitřní výplň line. Pokud chcete vykreslit vnitřní část line, nastavte její Xamarin_Forms _Shapes_Shape_Fill" data-linktype="absolute-path">Fill vlastnost na Color . Pokud chcete osnově čar dát obrys, nastavte Xamarin_Forms _Shapes_Shape_Stroke" data-linktype="absolute-path">Stroke vlastnost na Color .

Dokumentace k rozhraní API PrůvodceUkázka
example polyline
Kód jazyka C# pro tuto stránkuStránka XAML
Rectangle Rectangle zobrazí obdélník nebo čtverec. Pokud chcete vykreslit vnitřní část obdélníku, nastavte jeho Xamarin_Forms _Shapes_Shape_Fill" data-linktype="absolute-path">Fill vlastnost na Color . Pokud chcete obdélníku poskytnout obrys, nastavte jeho Xamarin_Forms _Shapes_Shape_Stroke" data-linktype="absolute-path">Stroke vlastnost na Color .

Dokumentace k rozhraní API PrůvodceUkázka
příklad obdélníku
Kód jazyka C# pro tuto stránkuStránka XAML
WebView WebViewzobrazí webové stránky nebo obsah HTML podle toho, jestli je vlastnost WebView Xamarin_Forms _WebView_Source" data-linktype="absolute-path">nastavená na Source objekt nebo UriWebViewSourceHtmlWebViewSource .

Dokumentace k rozhraní API PrůvodceUkázka 1 a 2
WebView example
Kód jazyka C# pro tuto stránkuStránka XAML

Zobrazení, která spouštějí příkazy

Typ Description Vzhled
Button Button je obdélníkový objekt, který zobrazuje text a který při stisknutí vyžádá Clicked událost.

Dokumentace k rozhraní API PrůvodceUkázka
s příkladem
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí
ImageButton ImageButton je obdélníkový objekt, který zobrazuje obrázek a který při stisknutí vyžádá Clicked událost.

Dokumentace k rozhraní API PrůvodceUkázka
imageButton example
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí
RadioButton RadioButton umožňuje výběr jedné možnosti ze sady a při CheckedChanged výběru vyvolá událost.

Dokumentace k rozhraní API PrůvodceUkázka
RadioButton Example
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí
RefreshView RefreshView je ovládací prvek kontejneru, který poskytuje funkci aktualizace tažením pro posouvání obsahu. Vlastnost definovaná vlastností se spustí při aktivaci aktualizace ICommand a vlastnost označuje aktuální stav CommandIsRefreshing ovládacího prvku.

Dokumentace k rozhraní API PrůvodceUkázka
RefreshView – příklad
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí
SearchBar SearchBar zobrazí oblast, do které může uživatel zadat textový řetězec, a tlačítko (nebo klávesovou zkratku), které aplikaci signalizuje, že má provést hledání. Vlastnost Xamarin_Forms _InputView_Text" data-linktype="absolute-path">poskytuje přístup k textu a událost indikuje, že tlačítko TextSearchButtonPressed bylo stisknuto.

Dokumentace k rozhraní API PrůvodceUkázka
příkladu
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí
SwipeView SwipeView je ovládací prvek kontejneru, který zalamuje položku obsahu a poskytuje položky místní nabídky, které jsou odhaleny gestem potažení. Každá položka nabídky je reprezentována objektem , který má vlastnost , která spustí objekt při jeho SwipeItemCommandICommand poklepu.

Dokumentace k rozhraní API PrůvodceUkázka
Příklad SwipeView Příklad
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí

Zobrazení pro nastavení hodnot

Typ Description Vzhled
CheckBox CheckBox umožňuje uživateli vybrat logickou hodnotu pomocí typu tlačítka, které je možné zaškrtnuté nebo prázdné. Vlastnost je stav objektu a událost je aktivována při IsChecked změně CheckBoxCheckedChanged stavu.

Dokumentace k rozhraní API PrůvodceUkázka
– příklad
Kód jazyka C# pro tuto stránkuStránka XAML
Slider Sliderumožňuje uživateli vybrat hodnotu ze souvislého rozsahu zadaného pomocí double Xamarin_Forms Slider _Slider_Minimum" data-linktype="absolute-path">and Minimum Xamarin_Forms double _Slider_Maximum" data-linktype="absolute-path">Maximum properties.

Dokumentace k rozhraní API PrůvodceUkázka
posuvníku Příklad
Kód jazyka C# pro tuto stránkuStránka XAML
Stepper Stepperumožňuje uživateli vybrat hodnotu z rozsahu přírůstkových hodnot zadaných pomocí double Xamarin_Forms Stepper _Stepper_Minimum" data-linktype="absolutní_cesta">Minimum , Xamarin_Forms double _Stepper_Maximum" data-linktype="absolutní_cesta">Maximum a Xamarin_Forms _Stepper_Increment" data-linktype="absolutní_cesta">Increment vlastnosti.

Dokumentace k rozhraní API PrůvodceUkázka
stepper example
Kód jazyka C# pro tuto stránkuStránka XAML
Switch Switch má formu přepínače pro zapnutí/vypnutí, který uživateli umožní vybrat logickou hodnotu. Vlastnost Xamarin_Forms _Switch_IsToggled" data-linktype="absolute-path">je stav přepínače a událost se zobrazí IsToggled při změně Toggled stavu.

Dokumentace k rozhraní API PrůvodceUkázka
příkladu
Kód jazyka C# pro tuto stránkuStránka XAML
DatePicker DatePicker umožňuje uživateli vybrat datum pomocí výběru data platformy. Nastavte rozsah přípustných kalendářních dat pomocí Xamarin_Forms _DatePicker_MinimumDate" data-linktype="absolute-path">and MinimumDate Xamarin_Forms MinimumDate _DatePicker_MaximumDate" data-linktype="absolute-path">MaximumDate vlastnosti. Vlastnost Xamarin_Forms _DatePicker_Date" data-linktype="absolute-path">je vybrané datum a událost se aktivují, když se Date tato vlastnost DateSelected změní.

Dokumentace k rozhraní API PrůvodceUkázka
v příkladu
Kód jazyka C# pro tuto stránkuStránka XAML
TimePicker TimePicker umožňuje uživateli vybrat čas s výběrem času platformy. Vlastnost Xamarin_Forms _TimePicker_Time data-linktype="absolute-path">Time je vybraný čas. Aplikace může monitorovat změny ve Time vlastnosti instalací obslužné rutiny pro PropertyChanged událost.

Dokumentace k rozhraní API PrůvodceUkázka
TimePicker
Kód jazyka C# pro tuto stránkuStránka XAML

Zobrazení pro úpravu textu

Tyto dvě třídy jsou odvozeny z třídy , která InputView definuje InputView Xamarin_Forms _InputView_Keyboard" data-linktype="absolute-path">Keyboard vlastnost:

Typ Description Vzhled
Entry Entry umožňuje uživateli zadat a upravit jeden řádek textu. Text je k dispozici jako vlastnost Xamarin_Forms _InputView_Text" data-linktype="absolute-path">a události a se aktivují, když se text změní nebo když uživatel signalizuje dokončení klepnutím na klávesu TextTextChangedCompleted Enter.

K Editor zadávání a úpravám více řádků textu použijte .

Dokumentace k rozhraní API PrůvodceUkázka
Příklad
Kód jazyka C# pro tuto stránkuStránka XAML
Editor Editor umožňuje uživateli zadat a upravit více řádků textu. Text je k dispozici jako vlastnost Xamarin_Forms _InputView_Text" data-linktype="absolute-path">a události a se aktivují, když se text změní nebo uživatel signalizuje TextTextChangedCompleted dokončení.

Zobrazení Entry slouží k zadávání a úpravám jednoho řádku textu.

Dokumentace k rozhraní API PrůvodceUkázka
příkladu
Kód jazyka C# pro tuto stránkuStránka XAML

Zobrazení pro indikování aktivity

Typ Description Vzhled
ActivityIndicator ActivityIndicator používá animaci k zobrazení, že aplikace je zapojená do zdlouhavé aktivity, aniž by indikoval průběh. Animace Xamarin_Forms _ActivityIndicator_IsRunning data-linktype="absolutní_cesta">IsRunning animace.

Pokud je průběh aktivity známý, použijte ProgressBar místo toho .

Dokumentace k rozhraní API PrůvodceUkázka
ActivityIndicator Example Example
Kód jazyka C# pro tuto stránkuStránka XAML
ProgressBar ProgressBar používá animaci k zobrazení, že aplikace postupuje zdlouhavou aktivitou. Nastavte Xamarin_Forms _ProgressBar_Progress data-linktype="absolute-path">na hodnoty v rozmezí 0 až Progress 1, které označují průběh.

Pokud průběh aktivity není známý, použijte ActivityIndicator místo toho .

Dokumentace k rozhraní API PrůvodceUkázka
ProgressBar
Kód jazyka C# pro tuto stránkuStránka XAML skódem na pozadí

Zobrazení kolekcí

Typ Description Vzhled
CarouselView CarouselView zobrazí posouvatelný seznam datových položek. Nastavte vlastnost na kolekci objektů a nastavte vlastnost na objekt popisující, jak mají být položky ItemsSourceItemTemplateDataTemplate formátovány. Událost CurrentItemChanged signalizuje, že se aktuálně zobrazená položka změnila, což je k dispozici jako CurrentItem vlastnost .

PrůvodceUkázka
– příklad
Kód jazyka C# pro tuto stránkuStránka XAML
CollectionView CollectionView zobrazí posouvatelný seznam vybratelných datových položek s použitím různých specifikací rozložení. Jejím cílem je poskytovat flexibilnější a výkonnější alternativu k ListView . Nastavte vlastnost na kolekci objektů a nastavte vlastnost na objekt popisující, jak mají být položky ItemsSourceItemTemplateDataTemplate formátovány. Událost SelectionChanged signalizuje, že byl proveden výběr, který je k dispozici jako SelectedItem vlastnost .

PrůvodceUkázka
příkladu CollectionView
Kód jazyka C# pro tuto stránkuStránka XAML
IndicatorView IndicatorView zobrazí indikátory, které reprezentují počet položek v CarouselView . Nastavte CarouselView.IndicatorView vlastnost na IndicatorView objekt pro zobrazení ukazatelů pro CarouselView .

Dokumentace k rozhraní API PrůvodceUkázka
příkladIndicatorViewpříklad
Kód jazyka C# pro tuto stránkuStránka XAML
ListView ListView je odvozen z ItemsView a zobrazuje seznam volitelných datových položek, které je k. Nastavte Xamarin_Forms vlastnost _ItemsView_1_ItemsSource data-LINKTYPE = "absolutní cesta" >ItemsSource na kolekci objektů a nastavte ItemsSource vlastnost Xamarin_Forms _ItemsView_1_ItemTemplate data-linktype = "absolutní cesta" >ItemTemplate na DataTemplate objekt popisující, jakým způsobem mají být položky naformátovány. ItemSelectedUdálost signalizuje, že byl proveden výběr, který je k dispozici jako Xamarin_Forms ItemSelected vlastnost _ListView_SelectedItem data-LINKTYPE = "absolutní cesta" >SelectedItem .

Dokumentace k rozhraní API PrůvodceUkázka
Příklad příklad ListView – příklad
Kód jazyka C# pro tuto stránkuStránka XAML
Picker Picker zobrazí vybranou položku ze seznamu textových řetězců a umožňuje výběr této položky, když je zobrazení klepnuto. Nastavte Xamarin_Forms vlastnost _Picker_Items data-LINKTYPE = "absolutní cesta" >Items na seznam řetězců nebo na Xamarin_Forms Items _Picker_ItemsSource data-linktype = "absolutní cesta" >ItemsSource vlastnost na kolekci objektů. SelectedIndexChangedUdálost se aktivuje, když se vybere položka.

PickerZobrazí seznam položek pouze v případě, že je vybrán. Použijte ListView nebo TableView pro rolovací seznam, který zůstane na stránce.

Dokumentace k rozhraní API PrůvodceUkázka
pro výběr příklad výběru v příkladu
Kód jazyka C# pro tuto stránkuStránka XAML s kódem na pozadí
TableView TableView Zobrazí seznam řádků typu Cell s nepovinnými záhlavími a podzáhlavími. Nastavte Xamarin_Forms vlastnost _TableView_Root data-LINKTYPE = "absolutní cesta" >Root na objekt typu TableRoot a přidejte TableSection do něj objekty TableRoot . Každé TableSection je kolekce Cell objektů.

Dokumentace k rozhraní API PrůvodceUkázka
příkladTableviewpříklad
Kód jazyka C# pro tuto stránkuStránka XAML