Xamarin.FormsSwidansichtXamarin.Forms SwipeView

Vorabrelease der API

Beispiel herunterladen Herunterladen des BeispielsDownload Sample Download the sample

Der SwipeView ist ein Container Steuerelement, das ein Element des Inhalts umschließt und Kontextmenü Elemente bereitstellt, die durch eine Schwenkbewegung angezeigt werden:The SwipeView is a container control that wraps around an item of content, and provides context menu items that are revealed by a swipe gesture:

Screenshot der swipeer View-Elemente in einer CollectionView unter IOS und AndroidScreenshot of SwipeView swipe items in a CollectionView, on iOS and Android

SwipeViewist in Xamarin.Forms 4,4 verfügbar.SwipeView is available in Xamarin.Forms 4.4. Es ist jedoch zurzeit experimentell und kann nur verwendet werden, indem der AppDelegate Klasse in Ios, ihrer MainActivity Klasse unter Android oder ihrer Klasse auf der UWP die folgende Codezeile hinzugefügt wird, App bevor aufgerufen wird Forms.Init :However, it's currently experimental and can only be used by adding the following line of code to your AppDelegate class on iOS, to your MainActivity class on Android, or to your App class on UWP, before calling Forms.Init:

Forms.SetFlags("SwipeView_Experimental");

SwipeView definiert die folgenden Eigenschaften:SwipeView defines the following properties:

  • LeftItemsvom Typ SwipeItems , der die schwingenden Elemente darstellt, die aufgerufen werden können, wenn das Steuerelement von der linken Seite entfernt wird.LeftItems, of type SwipeItems, which represents the swipe items that can be invoked when the control is swiped from the left side.
  • RightItemsvom Typ SwipeItems , der die schwingenden Elemente darstellt, die aufgerufen werden können, wenn das Steuerelement von der rechten Seite entfernt wird.RightItems, of type SwipeItems, which represents the swipe items that can be invoked when the control is swiped from the right side.
  • TopItemsvom Typ SwipeItems , der die schwingenden Elemente darstellt, die aufgerufen werden können, wenn das Steuerelement von oben nach unten entfernt wird.TopItems, of type SwipeItems, which represents the swipe items that can be invoked when the control is swiped from the top down.
  • BottomItemsvom Typ SwipeItems , der die schwingenden Elemente darstellt, die aufgerufen werden können, wenn das Steuerelement von unten nach oben geleitet wird.BottomItems, of type SwipeItems, which represents the swipe items that can be invoked when the control is swiped from the bottom up.

Diese Eigenschaften werden von Objekten unterstützt BindableProperty . Dies bedeutet, dass Sie Ziele von Daten Bindungen und formatiert sein können.These properties are backed by BindableProperty objects, which means that they can be targets of data bindings, and styled.

Außerdem SwipeView erbt die- Content Eigenschaft von der- ContentView Klasse.In addition, the SwipeView inherits the Content property from the ContentView class. Die Content -Eigenschaft ist die Content-Eigenschaft der SwipeView -Klasse und muss daher nicht explizit festgelegt werden.The Content property is the content property of the SwipeView class, and therefore does not need to be explicitly set.

Die- SwipeView Klasse definiert außerdem vier Ereignisse:The SwipeView class also defines four events:

  • SwipeStartedwird ausgelöst, wenn eine Schwenkbewegung gestartet wird.SwipeStarted is fired when a swipe starts. Das- SwipeStartedEventArgs Objekt, das dieses Ereignis begleitet, verfügt über eine- SwipeDirection Eigenschaft vom Typ SwipeDirection .The SwipeStartedEventArgs object that accompanies this event has a SwipeDirection property, of type SwipeDirection.
  • SwipeChangingwird ausgelöst, wenn der Schwenk bewegt wird.SwipeChanging is fired as the swipe moves. Das SwipeChangingEventArgs -Objekt, das dieses Ereignis begleitet, verfügt über eine SwipeDirection -Eigenschaft vom Typ SwipeDirection und eine- Offset Eigenschaft vom Typ double .The SwipeChangingEventArgs object that accompanies this event has a SwipeDirection property, of type SwipeDirection, and an Offset property of type double.
  • SwipeEndedwird ausgelöst, wenn eine flüpe endet.SwipeEnded is fired when a swipe ends. Das- SwipeEndedEventArgs Objekt, das dieses Ereignis begleitet, verfügt über eine- SwipeDirection Eigenschaft vom Typ SwipeDirection .The SwipeEndedEventArgs object that accompanies this event has a SwipeDirection property, of type SwipeDirection.
  • CloseRequestedwird ausgelöst, wenn die flüften Elemente geschlossen werden.CloseRequested is fired when the swipe items are closed.

Darüber hinaus SwipeView schließt Open die-Methode und die- Close Methode ein, die die Streifen Elemente Programm gesteuert öffnen und schließen.In addition, SwipeView includes Open and Close methods, which programmatically open and close the swipe items, respectively.

Hinweis

SwipeViewverfügt über eine plattformspezifische plattformspezifische unter IOS und Android, die den Übergang steuert, der beim Öffnen eines verwendet wird SwipeView .SwipeView has a platform-specific on iOS and Android, that controls the transition that's used when opening a SwipeView. Weitere Informationen finden Sie unter swipeer View Swipe Transition Mode on IOS and swipeer View Swipe Transition Mode on Android.For more information, see SwipeView Swipe Transition Mode on iOS and SwipeView Swipe Transition Mode on Android.

Erstellen einer swipeer ViewCreate a SwipeView

Ein SwipeView muss den Inhalt definieren, der SwipeView von umschlossen wird, und die von der Schwenkbewegung offenbarten Elemente.A SwipeView must define the content that the SwipeView wraps around, and the swipe items that are revealed by the swipe gesture. Die wischen-Elemente sind ein oder mehrere SwipeItem Objekte, die in einer der vier SwipeView direktionalen Auflistungen,,, oder platziert werden LeftItems RightItems TopItems BottomItems .The swipe items are one or more SwipeItem objects that are placed in one of the four SwipeView directional collections - LeftItems, RightItems, TopItems, or BottomItems.

Im folgenden Beispiel wird gezeigt, wie ein SwipeView in XAML instanziiert wird:The following example shows how to instantiate a SwipeView in XAML:

<SwipeView>
    <SwipeView.LeftItems>
        <SwipeItems>
            <SwipeItem Text="Favorite"
                       IconImageSource="favorite.png"
                       BackgroundColor="LightGreen"
                       Invoked="OnFavoriteSwipeItemInvoked" />
            <SwipeItem Text="Delete"
                       IconImageSource="delete.png"
                       BackgroundColor="LightPink"
                       Invoked="OnDeleteSwipeItemInvoked" />
        </SwipeItems>
    </SwipeView.LeftItems>
    <!-- Content -->
    <Grid HeightRequest="60"
          WidthRequest="300"
          BackgroundColor="LightGray">
        <Label Text="Swipe right"
               HorizontalOptions="Center"
               VerticalOptions="Center" />
    </Grid>
</SwipeView>

Der entsprechende C#-Code lautet:The equivalent C# code is:

// SwipeItems
SwipeItem favoriteSwipeItem = new SwipeItem
{
    Text = "Favorite",
    IconImageSource = "favorite.png",
    BackgroundColor = Color.LightGreen
};
favoriteSwipeItem.Invoked += OnFavoriteSwipeItemInvoked;

SwipeItem deleteSwipeItem = new SwipeItem
{
    Text = "Delete",
    IconImageSource = "delete.png",
    BackgroundColor = Color.LightPink
};
deleteSwipeItem.Invoked += OnDeleteSwipeItemInvoked;

List<SwipeItem> swipeItems = new List<SwipeItem>() { favoriteSwipeItem, deleteSwipeItem };

// SwipeView content
Grid grid = new Grid
{
    HeightRequest = 60,
    WidthRequest = 300,
    BackgroundColor = Color.LightGray
};
grid.Children.Add(new Label
{
    Text = "Swipe right",
    HorizontalOptions = LayoutOptions.Center,
    VerticalOptions = LayoutOptions.Center
});

SwipeView swipeView = new SwipeView
{
    LeftItems = new SwipeItems(swipeItems),
    Content = grid
};

In diesem Beispiel ist der SwipeView Inhalt eine Grid , die eine enthält Label :In this example, the SwipeView content is a Grid that contains a Label:

Screenshot von swidanview-Inhalten unter IOS und AndroidScreenshot of SwipeView content, on iOS and Android

Die wischen-Elemente werden verwendet, um Aktionen für den Inhalt auszuführen. Sie SwipeView werden angezeigt, wenn das Steuerelement von der linken Seite entfernt wird:The swipe items are used to perform actions on the SwipeView content, and are revealed when the control is swiped from the left side:

Screenshot der swidanview-Streifen Elemente unter IOS und AndroidScreenshot of SwipeView swipe items, on iOS and Android

Standardmäßig wird ein Schwenk Element ausgeführt, wenn es vom Benutzer getippt wird.By default, a swipe item is executed when it is tapped by the user. Dieses Verhalten kann jedoch geändert werden.However, this behavior can be changed. Weitere Informationen finden Sie unter Swipe-Modus.For more information, see Swipe mode.

Nachdem ein Schwenk Element ausgeführt wurde, werden die Schwenk Elemente ausgeblendet, und der SwipeView Inhalt wird erneut angezeigt.Once a swipe item has been executed the swipe items are hidden and the SwipeView content is re-displayed. Dieses Verhalten kann jedoch geändert werden.However, this behavior can be changed. Weitere Informationen finden Sie unter Swipe-Verhalten.For more information, see Swipe behavior.

Hinweis

Streifen Inhalt und Streifen Elemente können Inline eingefügt oder als Ressourcen definiert werden.Swipe content and swipe items can be placed inline, or defined as resources.

Elemente schwenkenSwipe items

Die LeftItems RightItems -, TopItems -,-und-Auflistungen BottomItems sind vom Typ SwipeItems .The LeftItems, RightItems, TopItems, and BottomItems collections are all of type SwipeItems. Die SwipeItems-Klasse definiert die folgenden Eigenschaften:The SwipeItems class defines the following properties:

  • Modevom Typ SwipeMode , der die Auswirkung einer Schwenk Interaktion angibt.Mode, of type SwipeMode, which indicates the effect of a swipe interaction. Weitere Informationen zum wischen-Modus finden Sie unter wischen-Modus.For more information about swipe mode, see Swipe mode.
  • SwipeBehaviorOnInvokedvom Typ SwipeBehaviorOnInvoked , der angibt, wie sich ein SwipeView verhält, nachdem ein wischen-Element aufgerufen wurde.SwipeBehaviorOnInvoked, of type SwipeBehaviorOnInvoked, which indicates how a SwipeView behaves after a swipe item is invoked. Weitere Informationen zum wischen-Verhalten finden Sie unter wischen-Verhalten.For more information about swipe behavior, see Swipe behavior.

Diese Eigenschaften werden von Objekten unterstützt BindableProperty . Dies bedeutet, dass Sie Ziele von Daten Bindungen und formatiert sein können.These properties are backed by BindableProperty objects, which means that they can be targets of data bindings, and styled.

Jedes "Wischen"-Element wird als SwipeItem -Objekt definiert, das in einer der vier direktionalen Auflistungen platziert wird SwipeItems .Each swipe item is defined as a SwipeItem object that's placed into one of the four SwipeItems directional collections. Die SwipeItem -Klasse wird von der MenuItem -Klasse abgeleitet und fügt die folgenden Member hinzu:The SwipeItem class derives from the MenuItem class, and adds the following members:

  • Eine BackgroundColor Eigenschaft vom Typ Color , die die Hintergrundfarbe für das Schwenk Element definiert.A BackgroundColor property, of type Color, that defines the background color of the swipe item. Diese Eigenschaft wird durch eine bindbare Eigenschaft unterstützt.This property is backed by a bindable property.
  • Ein Invoked Ereignis, das ausgelöst wird, wenn das wischen-Element ausgeführt wird.An Invoked event, which is fired when the swipe item is executed.

Wichtig

Die- MenuItem Klasse definiert mehrere Eigenschaften, einschließlich Command , CommandParameter , IconImageSource und Text .The MenuItem class defines several properties, including Command, CommandParameter, IconImageSource, and Text. Diese Eigenschaften können für ein-Objekt festgelegt werden SwipeItem , um die Darstellung zu definieren, und um einen zu definieren, ICommand der ausgeführt wird, wenn das wischen-Element aufgerufen wird.These properties can be set on a SwipeItem object to define its appearance, and to define an ICommand that executes when the swipe item is invoked. Weitere Informationen finden Sie unter Xamarin.Forms MenuItem.For more information, see Xamarin.Forms MenuItem.

Im folgenden Beispiel werden zwei- SwipeItem Objekte in der-Auflistung LeftItems einer angezeigt SwipeView :The following example shows two SwipeItem objects in the LeftItems collection of a SwipeView:

<SwipeView>
    <SwipeView.LeftItems>
        <SwipeItems>
            <SwipeItem Text="Favorite"
                       IconImageSource="favorite.png"
                       BackgroundColor="LightGreen"
                       Invoked="OnFavoriteSwipeItemInvoked" />
            <SwipeItem Text="Delete"
                       IconImageSource="delete.png"
                       BackgroundColor="LightPink"
                       Invoked="OnDeleteSwipeItemInvoked" />
        </SwipeItems>
    </SwipeView.LeftItems>
    <!-- Content -->
</SwipeView>

Die Darstellung der einzelnen SwipeItem wird durch eine Kombination der Text Eigenschaften, IconImageSource und definiert BackgroundColor :The appearance of each SwipeItem is defined by a combination of the Text, IconImageSource, and BackgroundColor properties:

Screenshot der swidanview-Streifen Elemente unter IOS und AndroidScreenshot of SwipeView swipe items, on iOS and Android

Wenn ein SwipeItem Invoked -Ereignis abgetippt wird, wird das zugehörige-Ereignis ausgelöst und vom registrierten Ereignishandler behandelt.When a SwipeItem is tapped, its Invoked event fires and is handled by its registered event handler. Alternativ kann die- Command Eigenschaft auf eine-Implementierung festgelegt werden ICommand , die ausgeführt wird, wenn SwipeItem aufgerufen wird.Alternatively, the Command property can be set to an ICommand implementation that will be executed when the SwipeItem is invoked.

Hinweis

Wenn die Darstellung eines SwipeItem nur mit der-Eigenschaft oder der-Eigenschaft definiert wird Text IconImageSource , wird der Inhalt immer zentriert.When the appearance of a SwipeItem is defined only using the Text or IconImageSource properties, the content is always centered.

Neben der Definition von Schwenk Elementen als SwipeItem Objekte ist es auch möglich, benutzerdefinierte Streifen Element Sichten zu definieren.In addition to defining swipe items as SwipeItem objects, it's also possible to define custom swipe item views. Weitere Informationen finden Sie unter benutzerdefinierte wischen-Elemente.For more information, see Custom swipe items.

Richtung schwenkenSwipe direction

SwipeViewunterstützt vier verschiedene Richtung, bei der die Richtung von der direktionalen Auflistung definiert wird, SwipeItems zu der die SwipeItem Objekte hinzugefügt werden.SwipeView supports four different swipe directions, with the swipe direction being defined by the directional SwipeItems collection the SwipeItem objects are added to. Jede Richtung kann eigene Streifen Elemente enthalten.Each swipe direction can hold its own swipe items. Das folgende Beispiel zeigt z. b. ein-Element, SwipeView dessen Streifen Elemente von der Schwenk Richtung abhängen:For example, the following example shows a SwipeView whose swipe items depend on the swipe direction:

<SwipeView>
    <SwipeView.LeftItems>
        <SwipeItems>
            <SwipeItem Text="Delete"
                       IconImageSource="delete.png"
                       BackgroundColor="LightPink"
                       Command="{Binding DeleteCommand}" />
        </SwipeItems>
    </SwipeView.LeftItems>
    <SwipeView.RightItems>
        <SwipeItems>
            <SwipeItem Text="Favorite"
                       IconImageSource="favorite.png"
                       BackgroundColor="LightGreen"
                       Command="{Binding FavoriteCommand}" />
            <SwipeItem Text="Share"
                       IconImageSource="share.png"
                       BackgroundColor="LightYellow"
                       Command="{Binding ShareCommand}" />
        </SwipeItems>
    </SwipeView.RightItems>
    <!-- Content -->
</SwipeView>

In diesem Beispiel kann der SwipeView Inhalt nach rechts oder Links geleitet werden.In this example, the SwipeView content can be swiped right or left. Wenn Sie nach rechts wischen, wird das Lösch Element angezeigt, während beim Schwenken auf der linken Seite die Favoriten -und Freigabe Elemente angezeigt werden.Swiping to the right will show the Delete swipe item, while swiping to the left will show the Favorite and Share swipe items.

Warnung

Auf einem kann jeweils nur eine Instanz einer direktionalen Auflistung SwipeItems festgelegt werden SwipeView .Only one instance of a directional SwipeItems collection can be set at a time on a SwipeView. Daher können Sie nicht über zwei LeftItems Definitionen für einen verfügen SwipeView .Therefore, you cannot have two LeftItems definitions on a SwipeView.

Das SwipeStarted SwipeChanging -Ereignis, das-Ereignis und das- SwipeEnded Ereignis melden die Schwenk Richtung über die- SwipeDirection Eigenschaft in den Ereignis Argumenten.The SwipeStarted, SwipeChanging, and SwipeEnded events report the swipe direction via the SwipeDirection property in the event arguments. Diese Eigenschaft SwipeDirection hat den Typ, bei dem es sich um eine Enumeration handelt, die aus vier Membern besteht:This property is of type SwipeDirection, which is an enumeration consisting of four members:

  • RightGibt an, dass eine Rechte Schwenkbewegung aufgetreten ist.Right indicates that a right swipe occurred.
  • LeftGibt an, dass eine linke Schwenkbewegung aufgetreten ist.Left indicates that a left swipe occurred.
  • UpGibt an, dass ein aufwärts schwenken aufgetreten ist.Up indicates that an upwards swipe occurred.
  • DownGibt an, dass eine Abwärtsbewegung aufgetreten ist.Down indicates that a downwards swipe occurred.

Schwenk ModusSwipe mode

Die- SwipeItems Klasse verfügt über eine- Mode Eigenschaft, die den Effekt einer wischen-Interaktion angibt.The SwipeItems class has a Mode property, which indicates the effect of a swipe interaction. Diese Eigenschaft sollte auf einen der Enumerationsmember festgelegt werden SwipeMode :This property should be set to one of the SwipeMode enumeration members:

  • RevealGibt an, dass eine schwenkbare Elemente angezeigt wird.Reveal indicates that a swipe reveals the swipe items. Dies ist der Standardwert der SwipeItems.Mode-Eigenschaft.This is the default value of the SwipeItems.Mode property.
  • ExecuteGibt an, dass ein wischen die Schwenk Elemente ausführt.Execute indicates that a swipe executes the swipe items.

Im Modus "anzeigen" wird ein vom Benutzer SwipeView zum Öffnen eines Menüs, das aus einem oder mehreren wischen Elementen besteht, zum Öffnen eines Menüs, das aus einem oder mehreren wischen Elementen hervorgeht, und für die Ausführung explizit tippen.In reveal mode, the user swipes a SwipeView to open a menu consisting of one or more swipe items, and must explicitly tap a swipe item to execute it. Nachdem das Schwenk Element ausgeführt wurde, werden die Schwenk Elemente geschlossen, und der SwipeView Inhalt wird erneut angezeigt.After the swipe item has been executed the swipe items are closed and the SwipeView content is re-displayed. Im Ausführungs Modus wird ein durch den Benutzer ein SwipeView , um ein Menü zu öffnen, das aus einem der weiteren Streifen Elemente besteht, die dann automatisch ausgeführt werden.In execute mode, the user swipes a SwipeView to open a menu consisting of one more swipe items, which are then automatically executed. Nach der Ausführung werden die Elemente geschlossen, und der SwipeView Inhalt wird erneut angezeigt.Following execution, the swipe items are closed and the SwipeView content is re-displayed.

Das folgende Beispiel zeigt einen SwipeView , der für die Verwendung des Ausführungs Modus konfiguriert ist:The following example shows a SwipeView configured to use execute mode:

<SwipeView>
    <SwipeView.LeftItems>
        <SwipeItems Mode="Execute">
            <SwipeItem Text="Delete"
                       IconImageSource="delete.png"
                       BackgroundColor="LightPink"
                       Command="{Binding DeleteCommand}" />
        </SwipeItems>
    </SwipeView.LeftItems>
    <!-- Content -->
</SwipeView>

In diesem Beispiel kann der SwipeView Inhalt direkt weitergeleitet werden, um das Schwenk Element anzuzeigen, das sofort ausgeführt wird.In this example, the SwipeView content can be swiped right to reveal the swipe item, which is executed immediately. Nach der Ausführung SwipeView wird der Inhalt erneut angezeigt.Following execution, the SwipeView content is re-displayed.

Swipe-VerhaltenSwipe behavior

Die- SwipeItems Klasse verfügt über eine- SwipeBehaviorOnInvoked Eigenschaft, die angibt, wie sich ein SwipeView verhält, nachdem ein wischen-Element aufgerufen wurde.The SwipeItems class has a SwipeBehaviorOnInvoked property, which indicates how a SwipeView behaves after a swipe item is invoked. Diese Eigenschaft sollte auf einen der Enumerationsmember festgelegt werden SwipeBehaviorOnInvoked :This property should be set to one of the SwipeBehaviorOnInvoked enumeration members:

  • AutoGibt an, dass im SwipeView Ausrichtungsmodus die geschlossen wird, nachdem ein Schwenk Element aufgerufen wurde, und im Ausführungs Modus SwipeView bleibt geöffnet, nachdem ein Schwenk Element aufgerufen wurde.Auto indicates that in reveal mode the SwipeView closes after a swipe item is invoked, and in execute mode the SwipeView remains open after a swipe item is invoked. Dies ist der Standardwert der SwipeItems.SwipeBehaviorOnInvoked-Eigenschaft.This is the default value of the SwipeItems.SwipeBehaviorOnInvoked property.
  • CloseGibt an, dass SwipeView geschlossen wird, nachdem ein Schwenk Element aufgerufen wurde.Close indicates that the SwipeView closes after a swipe item is invoked.
  • RemainOpenGibt an, dass SwipeView geöffnet bleibt, nachdem ein Element aufgerufen wurde.RemainOpen indicates that the SwipeView remains open after a swipe item is invoked.

Das folgende Beispiel zeigt einen SwipeView , der so konfiguriert ist, dass er geöffnet bleibt, nachdem ein Schwenk Element aufgerufen wurde:The following example shows a SwipeView configured to remain open after a swipe item is invoked:

<SwipeView>
    <SwipeView.LeftItems>
        <SwipeItems SwipeBehaviorOnInvoked="RemainOpen">
            <SwipeItem Text="Favorite"
                       IconImageSource="favorite.png"
                       BackgroundColor="LightGreen"
                       Invoked="OnFavoriteSwipeItemInvoked" />
            <SwipeItem Text="Delete"
                       IconImageSource="delete.png"
                       BackgroundColor="LightPink"
                       Invoked="OnDeleteSwipeItemInvoked" />
        </SwipeItems>
    </SwipeView.LeftItems>
    <!-- Content -->
</SwipeView>

Benutzerdefinierte Streifen ElementeCustom swipe items

Benutzerdefinierte wischen-Elemente können mit dem-Typ definiert werden SwipeItemView .Custom swipe items can be defined with the SwipeItemView type. Die SwipeItemView -Klasse wird von der ContentView -Klasse abgeleitet und fügt die folgenden Eigenschaften hinzu:The SwipeItemView class derives from the ContentView class, and adds the following properties:

  • Commandvom Typ ICommand , der ausgeführt wird, wenn ein Schwenk Element getippt wird.Command, of type ICommand, which is executed when a swipe item is tapped.
  • CommandParameter vom Typ object: der Parameter, der an Command übergeben wird.CommandParameter, of type object, which is the parameter that's passed to the Command.

Diese Eigenschaften werden von Objekten unterstützt BindableProperty . Dies bedeutet, dass Sie Ziele von Daten Bindungen und formatiert sein können.These properties are backed by BindableProperty objects, which means that they can be targets of data bindings, and styled.

Die- SwipeItemView Klasse definiert auch ein Invoked Ereignis, das ausgelöst wird, wenn das Element nach dem Ausführen von abgetippt wird Command .The SwipeItemView class also defines an Invoked event that's fired when the item is tapped, after the Command is executed.

Das folgende Beispiel zeigt ein- SwipeItemView Objekt in der-Auflistung LeftItems einer SwipeView :The following example shows a SwipeItemView object in the LeftItems collection of a SwipeView:

<SwipeView>
    <SwipeView.LeftItems>
        <SwipeItems>
            <SwipeItemView Command="{Binding CheckAnswerCommand}"
                           CommandParameter="{Binding Source={x:Reference resultEntry}, Path=Text}">
                <StackLayout Margin="10"
                             WidthRequest="300">
                    <Entry x:Name="resultEntry"
                           Placeholder="Enter answer"
                           HorizontalOptions="CenterAndExpand" />
                    <Label Text="Check"
                           FontAttributes="Bold"
                           HorizontalOptions="Center" />
                </StackLayout>
            </SwipeItemView>
        </SwipeItems>
    </SwipeView.LeftItems>
    <!-- Content -->
</SwipeView>

In diesem Beispiel SwipeItemView besteht aus einem StackLayout mit einem Entry und einem Label .In this example, the SwipeItemView comprises a StackLayout containing an Entry and a Label. Nachdem der Benutzereingaben in eingegeben Entry hat, kann der Rest des- SwipeViewItem Objekts abgetippt werden, das die ICommand durch die-Eigenschaft definierte ausführt SwipeItemView.Command .After the user enters input into the Entry, the rest of the SwipeViewItem can be tapped which executes the ICommand defined by the SwipeItemView.Command property.

Programmgesteuertes Öffnen und Schließen von SwipeViewOpen and close a SwipeView programmatically

SwipeViewschließt Open die-Methode und die- Close Methode ein, die die-Streifen Elemente Programm gesteuert öffnen und schließen.SwipeView includes Open and Close methods, which programmatically open and close the swipe items, respectively.

Die- Open Methode erfordert ein- OpenSwipeItem Argument, um die Richtung anzugeben, SwipeView von der aus geöffnet wird.The Open method requires an OpenSwipeItem argument, to specify the direction the SwipeView will be opened from. Die- OpenSwipeItem Enumeration hat vier Member:The OpenSwipeItem enumeration has four members:

  • LeftItemsGibt an, dass das-Element SwipeView von Links aus geöffnet wird, um die wischen-Elemente in der Auflistung anzuzeigen LeftItems .LeftItems, which indicates that the SwipeView will be opened from the left, to reveal the swipe items in the LeftItems collection.
  • TopItemsGibt an, dass das-Element SwipeView von oben aus geöffnet wird, um die Schwenk Elemente in der Auflistung anzuzeigen TopItems .TopItems, which indicates that the SwipeView will be opened from the top, to reveal the swipe items in the TopItems collection.
  • RightItemsGibt an, dass das-Element SwipeView von der rechten Seite aus geöffnet wird, um die wischen-Elemente in der Auflistung anzuzeigen RightItems .RightItems, which indicates that the SwipeView will be opened from the right, to reveal the swipe items in the RightItems collection.
  • BottomItemsGibt an, dass das-Element SwipeView von der unteren Seite aus geöffnet wird, um die Schwenk Elemente in der Auflistung anzuzeigen BottomItems .BottomItems, which indicates that the SwipeView will be opened from the bottom, to reveal the swipe items in the BottomItems collection.

SwipeView swipeView Im folgenden Beispiel wird gezeigt, wie ein geöffnet wird, SwipeView um die wischen-Elemente in der Auflistung anzuzeigen LeftItems :Given a SwipeView named swipeView, the following example shows how to open a SwipeView to reveal the swipe items in the LeftItems collection:

swipeView.Open(OpenSwipeItem.LeftItems);

Der swipeView kann dann mit der-Methode geschlossen werden Close :The swipeView can then be closed with the Close method:

swipeView.Close();

Hinweis

Wenn die- Close Methode aufgerufen wird, CloseRequested wird das-Ereignis ausgelöst.When the Close method is invoked, the CloseRequested event is fired.

Deaktivieren von swipeer ViewDisable a SwipeView

Eine Anwendung kann einen Status eingeben, bei dem das Schwenken eines Inhalts Elements kein gültiger Vorgang ist.An application may enter a state where swiping an item of content is not a valid operation. In solchen Fällen kann der deaktiviert werden, indem die zugehörige- SwipeView Eigenschaft auf festgelegt wird IsEnabled false .In such cases, the SwipeView can be disabled by setting its IsEnabled property to false. Dadurch wird verhindert, dass Benutzerinhalte schwenken, um Streifen Elemente anzuzeigen.This will prevent users from being able to swipe content to reveal swipe items.

Außerdem kann beim Definieren der- Command Eigenschaft eines oder des-Delegaten SwipeItem SwipeItemView CanExecute ICommand angegeben werden, um das wischen-Element zu aktivieren oder zu deaktivieren.In addition, when defining the Command property of a SwipeItem or SwipeItemView, the CanExecute delegate of the ICommand can be specified to enable or disable the swipe item.