CurrentChangingEventArgs Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml.Data

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Daten für das CurrentChanging-Ereignis bereit .

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CurrentChangingEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class CurrentChangingEventArgs

Public Class CurrentChangingEventArgs

Vererbung: Object IInspectable CurrentChangingEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 xaml den Inhalt einer Seite an, deren GridView an eine CollectionViewSource gebunden ist. Das CodeBehind zeigt die CollectionViewSource-Initialisierung , die das Festlegen der Quelle und das Abrufen ihrer 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 CurrentChanging-Ereignis tritt auf, wenn sich der CurrentItem-Eigenschaftswert in einer ICollectionView-Implementierung ändert. Die ICollectionView-Implementierung verwendet den CurrentChangingEventArgs-Konstruktor, um anzugeben, ob Sie die CurrentItem-Änderung in einem CurrentChanging-Ereignishandler abbrechen können. Wenn der Wert der IsCancelable-Eigenschafttrue ist, können Sie die CurrentItem-Änderung abbrechen, indem Sie die Cancel-Eigenschaft auf true festlegen. Andernfalls können Sie die CurrentItem-Änderung nicht abbrechen.

Konstruktoren

CurrentChangingEventArgs()	Initialisiert eine neue instance der CurrentChangingEventArgs-Klasse.
CurrentChangingEventArgs(Boolean)	Initialisiert eine neue instance der CurrentChangingEventArgs-Klasse.

Eigenschaften

Cancel	Ruft einen Wert ab, der angibt, ob die CurrentItem-Änderung abgebrochen werden soll, oder legt diesen fest.
IsCancelable	Ruft einen Wert ab, der angibt, ob die CurrentItem-Änderung abgebrochen werden kann.

Gilt für: