ICollectionView.CurrentChanging Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При реализации этого интерфейса срабатывает это событие перед изменением текущего элемента. Обработчик событий может отменить это событие.
// 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
Тип события
Примеры
В следующем примере кода показано, как обрабатывать событие CurrentChanging. В этом примере xaml показывает содержимое страницы с GridView, привязанной к CollectionViewSource. Код программной части показывает инициализацию CollectionViewSource , которая включает настройку источника и получение представления для подключения обработчика событий 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;
}
}
Комментарии
Событие CurrentChanging возникает при изменении значения свойства CurrentItem . Параметр CurrentChangingEventArgs , передаваемый обработчику событий, указывает сведения об изменении. Если параметр IsCancelable имеет значение true, обработчик событий может отменить изменение, задав для параметра Cancel значение true. Если изменение отменено, CurrentItem не изменяется. Если параметру Cancel присвоено значение true, если параметру IsCancelable присвоено значение false, создается исключение.
Классы, реализующие этот интерфейс, должны запускать событие CurrentChanging, устанавливать IsCancelable соответствующим образом, а затем проверка свойство Cancel перед изменением CurrentItem и запуском события CurrentChanged.