Xamarin.Forms Görünümler

  • Makale

Xamarin.Forms görünümler, platformlar arası mobil kullanıcı arabirimlerinin yapı taşlarıdır.

Görünümler, etiketler, düğmeler ve kaydırıcılar gibi diğer grafik programlama ortamlarındaki denetimler veya pencere öğeleri olarak bilinen kullanıcı arabirimi nesneleridir. Tümü tarafından Xamarin.Forms desteklenen görünümler sınıfından View türetilir. Bunlar birkaç kategoriye ayrılabilir:

Sunuma yönelik görünümler

Type Açıklama Görünüm
BoxView BoxView özelliği tarafından Color renklendirilmiş düz bir dikdörtgen görüntüler. BoxView varsayılan boyut isteği 40x40'tır. Diğer boyutlar için ve HeightRequest özelliklerini atayınWidthRequest.

API Belge / Kılavuzu		 BoxView Örneği
Bu sayfa XAML sayfası / için C# kodu
Ellipse Ellipsex HeightRequestboyutunda WidthRequest bir üç nokta veya daire görüntüler. Üç noktanın içini boyamak için özelliğini olarak ColorayarlayınFill. Üç noktaya bir ana hat vermek için özelliğini olarak ColorayarlayınStroke.

API Belge / Kılavuzu		 Üç Nokta Örneği
Bu sayfa XAML sayfası / için C# kodu
Label Label sabit veya değişken biçimlendirmeli tek satırlı metin dizelerini veya çok satırlı metin bloklarını görüntüler. Text Özelliğini sabit biçimlendirme için bir dize olarak ayarlayın veya değişken biçimlendirmesi için özelliğini bir FormattedString nesne olarak ayarlayınFormattedText.

API Belge / Kılavuzu		 Etiket Örneği
Bu sayfa XAML sayfası / için C# kodu
Line Line bir başlangıç noktasından bitiş noktasına bir çizgi görüntüler. Başlangıç noktası ve Y1 özellikleriyleX1, bitiş noktası ise ve Y2 özellikleriyle X2 temsil edilir. Çizgiyi renklendirmek için özelliğini olarak ColorayarlayınStroke.

API Belge / Kılavuzu		 Satır Örneği
Bu sayfa XAML sayfası / için C# kodu
Image Image bit eşlem görüntüler. Bit eşlemler Web üzerinden indirilebilir, ortak proje veya platform projelerine kaynak olarak eklenebilir veya bir .NET Stream nesnesi kullanılarak oluşturulabilir.

API Belge / Kılavuzu		 Resim Örneği
Bu sayfa XAML sayfası / için C# kodu
Map Map bir harita görüntüler. Xamarin.Forms.Haritalar NuGet paketi yüklenmelidir. Android ve Evrensel Windows Platformu bir harita yetkilendirme anahtarı gerektirir.

API Belge / Kılavuzu		 Harita Örneği
Bu sayfa XAML sayfası / için C# kodu
OpenGLView OpenGLView iOS ve Android projelerinde OpenGL grafiklerini görüntüler. Evrensel Windows Platformu için destek yoktur. iOS ve Android projeleri, OpenTK-1.0 derlemesine veya OpenTK sürüm 1.0.0.0 derlemesine başvuru gerektirir. OpenGLView Paylaşılan Projede kullanmak daha kolaydır; .NET Standart kitaplığında kullanılıyorsa bağımlılık hizmeti de gerekir (örnek kodda gösterildiği gibi).

Bu, içinde Xamarin.Formsyerleşik olarak bulunan tek grafik tesisidir, ancak bir Xamarin.Forms uygulama veya UrhoSharpkullanarak SkiaSharpda grafik işleyebilir.

API Belgeleri

 OpenGLView Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu
Path Path eğrileri ve karmaşık şekilleri görüntüler. Data özelliği, çizilecek şekli belirtir. Şekli renklendirmek için özelliğini olarak ColorayarlayınStroke.

API Belge / Kılavuzu		 Yol Örneği
Bu sayfa XAML sayfası / için C# kodu
Polygon Polygon çokgen görüntüler. Points özelliği çokgenin köşe noktalarını belirtirkenFillRule, özelliği çokgenin iç dolgusunun nasıl belirlendiğini belirtir. Çokgenin içini boyamak için özelliğini olarak ColorayarlayınFill. Çokgene bir ana hat vermek için özelliğini olarak ColorayarlayınStroke.

API Belge / Kılavuzu		 Çokgen Örneği
Bu sayfa XAML sayfası / için C# kodu
Polyline Polyline bir dizi bağlı düz çizgi görüntüler. Points özelliği, çok çizginin köşe noktalarını belirtirken FillRule özelliği, çok çizginin iç dolgusunun nasıl belirlendiğini belirtir. Çok çizginin içini boyamak için özelliğini olarak ColorayarlayınFill. Çok çizgiye bir ana hat vermek için özelliğini olarak ColorayarlayınStroke.

API Belge / Kılavuzu		 Çok Çizgili Örnek
Bu sayfa XAML sayfası / için C# kodu
Rectangle Rectangle bir dikdörtgen veya kare görüntüler. Dikdörtgenin içini boyamak için özelliğini olarak ColorayarlayınFill. Dikdörtgene bir ana hat vermek için özelliğini olarak ColorayarlayınStroke.

API Belge / Kılavuzu		 Dikdörtgen Örneği
Bu sayfa XAML sayfası / için C# kodu
WebView WebViewözelliğin bir UriWebViewSource veya bir nesne olarak ayarlanıp ayarlanmadığına Source bağlı olarak Web sayfalarını veya HtmlWebViewSource HTML içeriğini görüntüler.

API Belge / Kılavuzu		 WebView Örneği
Bu sayfa XAML sayfası / için C# kodu

Komutları başlatan görünümler

Type Açıklama Görünüm
Button Button metin görüntüleyen ve basıldığında bir olayı tetikleyen dikdörtgen bir Clicked nesnedir.

API Belge / Kılavuzu		 Düğme Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu
ImageButton ImageButton , bir görüntü görüntüleyen ve basıldığında bir olayı tetikleyen dikdörtgen bir Clicked nesnedir.

API Belge / Kılavuzu		 ImageButton Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu
RadioButton RadioButton bir kümeden bir seçeneğin seçilmesine izin verir ve seçim gerçekleştiğinde bir CheckedChanged olayı tetikler.

API Belge / Kılavuzu		 RadioButton Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu
RefreshView RefreshView kaydırılabilir içerik için çekme-yenileme işlevselliği sağlayan bir kapsayıcı denetimidir. ICommand özelliği tarafından Command tanımlanan bir yenileme tetiklendiğinde yürütülür ve IsRefreshing özelliği denetimin geçerli durumunu gösterir.

API Belge / Kılavuzu		 RefreshView Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu
SearchBar SearchBar kullanıcının bir metin dizesi yazması için bir alan ve uygulamaya arama yapması için sinyal veren bir düğme (veya klavye tuşu) görüntüler. Text özelliği metne erişim sağlar ve SearchButtonPressed olay düğmeye basıldığını gösterir.

API Belge / Kılavuzu		 Arama Çubuğu Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu
SwipeView SwipeView , bir içerik öğesinin çevresinde kaydırılan ve çekme hareketiyle ortaya konan bağlam menüsü öğeleri sağlayan bir kapsayıcı denetimidir. Her menü öğesi, öğeye dokunulduğunda yürüten bir Command özelliği olan bir ICommand ile temsil edilirSwipeItem.

API Belge / Kılavuzu		 SwipeView Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu

Değerleri ayarlamaya yönelik görünümler

Type Açıklama Görünüm
CheckBox CheckBox kullanıcının denetlenebilen veya boş olabilecek bir düğme türü kullanarak Boole değeri seçmesine izin verir. IsChecked özelliği, durumunun CheckBoxdurumudur ve durum değiştiğinde CheckedChanged olay tetiklenir.

API Belge / Kılavuzu		 CheckBox Örneği
Bu sayfa XAML sayfası / için C# kodu
Slider Sliderkullanıcının ve Maximum özellikleriyle belirtilen sürekli aralıktan bir double değer seçmesine Minimum izin verir.

API Belge / Kılavuzu		 Kaydırıcı Örneği
Bu sayfa XAML sayfası / için C# kodu
Stepper Stepperkullanıcının , Maximumve Increment özellikleriyle belirtilen artımlı değerler aralığından bir double değer seçmesine Minimumolanak tanır.

API Belge / Kılavuzu		 Stepper Örneği
Bu sayfa XAML sayfası / için C# kodu
Switch Switch kullanıcının Boole değeri seçmesine izin vermek için açma/kapatma anahtarı biçimini alır. IsToggled özelliği anahtarın durumudur ve durum değiştiğinde Toggled olay tetiklenir.

API Belge / Kılavuzu		 Örnek Değiştir
Bu sayfa XAML sayfası / için C# kodu
DatePicker DatePicker kullanıcının platform tarih seçicisiyle bir tarih seçmesine izin verir. ve MaximumDate özellikleriyle MinimumDate izin verilebilen bir tarih aralığı ayarlayın. Date özelliği seçili tarihtir ve bu özellik değiştiğinde DateSelected olay tetiklenir.

API Belge / Kılavuzu		 DatePicker Örneği
Bu sayfa XAML sayfası / için C# kodu
TimePicker TimePicker kullanıcının platform zaman seçicisi ile bir saat seçmesine izin verir. Time özelliği seçilen saattir. Bir uygulama, olay için bir işleyici yükleyerek özelliğindeki TimePropertyChanged değişiklikleri izleyebilir.

API Belge / Kılavuzu		 TimePicker Örneği
Bu sayfa XAML sayfası / için C# kodu

Metin düzenlemeye yönelik görünümler

Bu iki sınıf, özelliğini tanımlayan sınıfından Keyboard türetilirInputView:

Type Açıklama Görünüm
Entry Entry kullanıcının tek bir metin satırı girmesini ve düzenlemesini sağlar. Metin özelliği olarak Text kullanılabilir ve TextChanged metin değiştiğinde veya kullanıcı enter tuşuna dokunarak tamamlanma sinyali verdiği zaman ve Completed olayları tetiklenir.

Birden çok metin satırı girmek ve düzenlemek için bir Editor kullanın.

API Belge / Kılavuzu		 Giriş Örneği
Bu sayfa XAML sayfası / için C# kodu
Editor Editor kullanıcının birden çok metin satırı girmesini ve düzenlemesini sağlar. Metin özelliği olarak Text kullanılabilir ve metin değiştiğinde TextChanged veya kullanıcı tamamlanma sinyali verince ve Completed olayları tetiklenir.

Tek bir Entry metin satırı girmek ve düzenlemek için bir görünüm kullanın.

API Belge / Kılavuzu		 Düzenleyici Örneği
Bu sayfa XAML sayfası / için C# kodu

Etkinliği belirtmeye yönelik görünümler

Type Açıklama Görünüm
ActivityIndicator ActivityIndicator , uygulamanın ilerleme durumunu belirtmeden uzun bir etkinlikle meşgul olduğunu göstermek için bir animasyon kullanır. IsRunning özelliği animasyonu denetler.

Etkinliğin ilerleme durumu biliniyorsa, bunun yerine bir ProgressBar kullanın.

API Belge / Kılavuzu		 ActivityIndicator Örneği
Bu sayfa XAML sayfası / için C# kodu
ProgressBar ProgressBar uygulamanın uzun bir etkinlikte ilerlediğini göstermek için bir animasyon kullanır. İlerleme durumunu Progress belirtmek için özelliğini 0 ile 1 arasında değerlere ayarlayın.

Etkinliğin ilerleme durumu bilinmiyorsa, bunun yerine bir ActivityIndicator kullanın.

API Belge / Kılavuzu		 ProgressBar Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu

Koleksiyonları görüntüleyen görünümler

Type Açıklama Görünüm
CarouselView CarouselView veri öğelerinin kaydırılabilir bir listesini görüntüler. ItemsSource özelliğini bir nesne koleksiyonuna, özelliğini ise öğelerin nasıl biçimlendirildiğini açıklayan bir DataTemplate nesneye ayarlayınItemTemplate. Olay, CurrentItemChanged şu anda görüntülenen öğenin değiştirildiğini ve özellik olarak CurrentItem kullanılabilir olduğunu belirtir.

Kılavuzu		 CarouselView Örneği
Bu sayfa XAML sayfası / için C# kodu
CollectionView CollectionView , farklı düzen belirtimlerini kullanarak seçilebilir veri öğelerinin kaydırılabilir bir listesini görüntüler. için daha esnek ve performanslı bir alternatif sağlamayı ListViewamaçlar. ItemsSource özelliğini bir nesne koleksiyonuna, özelliğini ise öğelerin nasıl biçimlendirildiğini açıklayan bir DataTemplate nesneye ayarlayınItemTemplate. Olay SelectionChanged , özellik olarak SelectedItem kullanılabilen bir seçim yapıldığını belirtir.

Kılavuzu		 CollectionView Örneği
Bu sayfa XAML sayfası / için C# kodu
IndicatorView IndicatorView içindeki öğe CarouselViewsayısını temsil eden göstergeleri görüntüler. CarouselView.IndicatorView için göstergeleri görüntülemek için özelliğini IndicatorView nesnesine CarouselViewayarlayın.

API Belge / Kılavuzu		 IndicatorView Örneği
Bu sayfa XAML sayfası / için C# kodu
ListView ListView öğesinden ItemsView türetilir ve seçilebilir veri öğelerinin kaydırılabilir bir listesini görüntüler. ItemsSource özelliğini bir nesne koleksiyonuna, özelliğini ise öğelerin nasıl biçimlendirildiğini açıklayan bir DataTemplate nesneye ayarlayınItemTemplate. Olay ItemSelected , özellik olarak SelectedItem kullanılabilen bir seçim yapıldığını belirtir.

API Belge / Kılavuzu		 ListView Örneği
Bu sayfa XAML sayfası / için C# kodu
Picker Picker metin dizeleri listesinden seçilen bir öğeyi görüntüler ve görünüme dokunulduğunda bu öğenin seçilmesine izin verir. Items özelliğini dizeler listesine veya ItemsSource özelliğini bir nesne koleksiyonuna ayarlayın. Bir SelectedIndexChanged öğe seçildiğinde olay tetiklenir.

öğe Picker listesini yalnızca seçili olduğunda görüntüler. ListView Sayfada kalan kaydırılabilir liste için veya TableView kullanın.

API Belge / Kılavuzu		 Seçici Örneği
Arka planda kod içeren bu sayfa / XAML sayfası için C# kodu
TableView TableView , isteğe bağlı üst bilgiler ve alt başlıklar içeren tür Cell satırlarının listesini görüntüler. Root özelliğini türünde TableRootbir nesne olarak ayarlayın ve bu TableRootnesneye nesne ekleyinTableSection. Her TableSection biri bir nesne koleksiyonudur Cell .

API Belge / Kılavuzu		 TableView Örneği
Bu sayfa XAML sayfası / için C# kodu