ICollectionView.CurrentChanging 事件

定义

命名空间:

Windows.UI.Xaml.Data

实现此接口时，请在更改当前项之前触发此事件。 事件处理程序可以取消此事件。

// Register
event_token CurrentChanging(CurrentChangingEventHandler const& handler) const;

// Revoke with event_token
void CurrentChanging(event_token const* cookie) const;

// Revoke with event_revoker
ICollectionView::CurrentChanging_revoker CurrentChanging(auto_revoke_t, CurrentChangingEventHandler const& handler) const;

event CurrentChangingEventHandler CurrentChanging;

function onCurrentChanging(eventArgs) { /* Your code */ }
iCollectionView.addEventListener("currentchanging", onCurrentChanging);
iCollectionView.removeEventListener("currentchanging", onCurrentChanging);
- or -
iCollectionView.oncurrentchanging = onCurrentChanging;

Event CurrentChanging As CurrentChangingEventHandler 

事件类型

CurrentChangingEventHandler

示例

下面的代码示例演示如何处理 CurrentChanging 事件。 在此示例中，XAML 显示具有 绑定到 CollectionViewSource 的 GridView 的页面的内容。 代码隐藏显示 CollectionViewSource 初始化，其中包括设置其 Source 和检索其 View 以附加 CurrentChanging 事件处理程序。

<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;
    }
}

注解

CurrentItem 属性值发生更改时发生 CurrentChanging 事件。 传递给事件处理程序的 CurrentChangingEventArgs 参数指定有关更改的信息。 如果 IsCancelable 为 true，则事件处理程序可以通过将 Cancel 设置为 true 来取消更改。 如果取消更改， 则 CurrentItem 不会更改。 当 IsCancelable 为 false 时将 Cancel 设置为 true 将引发异常。

实现此接口的类应触发 Current Change 事件，根据需要设置 IsCancelable，然后在更改 CurrentItem 和触发 CurrentChanged 事件之前检查 Cancel 属性。