CurrentChangingEventHandler Delegat

Definition

Namespace:

Microsoft.UI.Xaml.Data

Stellt eine Methode dar, die das CurrentChanging-Ereignis einer ICollectionView-Implementierung verarbeiten kann.

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(1026201821, 38323, 24533, 147, 180, 161, 162, 89, 159, 34, 92)]
public delegate void CurrentChangingEventHandler(object sender, CurrentChangingEventArgs e);

Public Delegate Sub CurrentChangingEventHandler(sender As Object, e As CurrentChangingEventArgs)

Parameter

sender

Object

Die Quelle des Ereignisses.

e

CurrentChangingEventArgs

Die Ereignisdaten.

Attribute

ContractVersionAttribute GuidAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das CurrentChanging-Ereignis behandelt wird . In diesem Beispiel zeigt das XAML den Inhalt einer Seite an, deren GridView an eine CollectionViewSource gebunden ist. Der CodeBehind zeigt die CollectionViewSource-Initialisierung , die das Festlegen der Quelle und das Abrufen der Ansicht umfasst, um den CurrentChanging-Ereignishandler anzufügen.

<Page.Resources>
  <CollectionViewSource x:Name="cvs" />
  <DataTemplate x:Key="myDataTemplate">
    <Border Background="#FF939598" Width="200" Height="200">
      <TextBlock Text="{Binding Path=Name}" />
    </Border>
  </DataTemplate>
</Page.Resources>

<Grid Background="{StaticResource ApplicationPageBackgroundBrush}">
  <GridView x:Name="PicturesGrid" 
    SelectionMode="Single" CanReorderItems="False" CanDragItems="False"
    ItemsSource="{Binding Source={StaticResource cvs}}"                
    ItemTemplate="{StaticResource myDataTemplate}" >
    <GridView.ItemsPanel>
      <ItemsPanelTemplate>
        <WrapGrid VerticalChildrenAlignment="Top" 
          HorizontalChildrenAlignment="Left" />
      </ItemsPanelTemplate>
    </GridView.ItemsPanel>
  </GridView>
</Grid>

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    var library = Windows.Storage.KnownFolders.PicturesLibrary;
    var queryOptions = new Windows.Storage.Search.QueryOptions();
    queryOptions.FolderDepth = Windows.Storage.Search.FolderDepth.Deep;
    queryOptions.IndexerOption = 
        Windows.Storage.Search.IndexerOption.UseIndexerWhenAvailable;

    var fileQuery = library.CreateFileQueryWithOptions(queryOptions);

    var fif = new Windows.Storage.BulkAccess.FileInformationFactory(
        fileQuery, 
        Windows.Storage.FileProperties.ThumbnailMode.PicturesView, 190, 
        Windows.Storage.FileProperties.ThumbnailOptions.UseCurrentScale, 
        false);

    var dataSource = fif.GetVirtualizedFilesVector();
    cvs.Source = dataSource;
    cvs.View.CurrentChanging += View_CurrentChanging;
}

private void View_CurrentChanging(object sender, CurrentChangingEventArgs e)
{
    Debug.WriteLine("Cancel = " + e.Cancel);
    Debug.WriteLine("IsCancelable = " + e.IsCancelable);
    if (e.IsCancelable == true)
    {
        // Cancel the change. The previously selected item remains selected.
        e.Cancel = true;
    }
}

Hinweise

Das ICollectionView.CurrentChanging-Ereignis tritt auf, wenn sich der CurrentItem-Eigenschaftswert ändert. Der An den Ereignishandler übergebene Parameter CurrentChangingEventArgs gibt Informationen zur Änderung an.

Wenn IsCancelabletrue ist, kann der Ereignishandler die Änderung abbrechen, indem Er Abbrechen auf true festlegt. Wenn die Änderung abgebrochen wird, wird CurrentItem nicht geändert. Wenn Cancel auf true festgelegt wird, wenn IsCancelablefalse ist, wird eine Ausnahme ausgelöst.

Weitere Informationen

• XAML-Datenbindungsbeispiel
• Datenbindung im Detail