CurrentChangingEventHandler Delegat

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Data
Bearbeiten

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

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(4085812664, 5023, 19918, 141, 201, 247, 241, 68, 77, 17, 133)]
class CurrentChangingEventHandler : MulticastDelegate
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(4085812664, 5023, 19918, 141, 201, 247, 241, 68, 77, 17, 133)]
public delegate void CurrentChangingEventHandler(object sender, CurrentChangingEventArgs e);
Public Delegate Sub CurrentChangingEventHandler(sender As Object, e As CurrentChangingEventArgs)

Parameter

sender
Object

IInspectable

Die Quelle des Ereignisses.

e
CurrentChangingEventArgs

Die Ereignisdaten.

Attribute
ContractVersionAttribute GuidAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

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.

Gilt für:

Weitere Informationen