Condividi tramite

RoutedEvent Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Rappresenta un evento indirizzato al sistema di eventi Windows Runtime.

public ref class RoutedEvent sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RoutedEvent final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RoutedEvent
Public NotInheritable Class RoutedEvent
Ereditarietà
Object Platform::Object IInspectable RoutedEvent
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute

Esempio

In questo esempio viene illustrata la sintassi di base per collegare un gestore eventi con AddHandler e handledEventsToo come true. In questo caso l'evento collegato è Tapped e l'identificatore RoutedEvent-type usato nell'esempio è TappedEvent. La posizione tipica dei gestori di fili è Caricata per una pagina o OnApplyTemplate per un controllo modello.

void MainPage::pageRoot_Tapped(Platform::Object^ sender, Windows::UI::Xaml::Input::TappedRoutedEventArgs^ e)
{
     //implementation
}
void MainPage::pageRoot_Loaded(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
     this->AddHandler(UIElement::TappedEvent, ref new TappedEventHandler(this, &MainPage::pageRoot_Tapped), true);
}

private void pageRoot_Tapped(object sender, TappedRoutedEventArgs e)
{
    //implementation
}
private void pageRoot_Loaded_1(object sender, RoutedEventArgs e)
{
    this.AddHandler(UIElement.TappedEvent, new TappedEventHandler(pageRoot_Tapped), true);
}

Commenti

Nota

Il sistema di eventi Windows Runtime non consente di creare un evento indirizzato personalizzato. Solo il Windows Runtime stesso può definire un evento in modo che abbia il comportamento dell'evento indirizzato.

Per altre informazioni sul funzionamento degli eventi indirizzati, vedere Panoramica degli eventi e degli eventi indirizzati. Il RoutedEvent tipo fa parte dell'infrastruttura per gli eventi indirizzati, ma non si usa RoutedEvent direttamente nella programmazione tipica dell'app Windows Runtime.

Lo scopo del tipo è quello di RoutedEvent fungere da identificatore per il sistema di eventi Windows Runtime, simile al modo in cui DependencyProperty fornisce un tipo di identificatore per il sistema delle proprietà di dipendenza. UIElement include diverse proprietà di sola lettura statiche di tipo RoutedEvent, denominate usando un modello di denominazione. Ogni RoutedEvent proprietà è denominata dopo un evento più il suffisso "Event". Ogni proprietà è l'identificatore dell'evento indirizzato che inizia con il nome. Ad esempio, TappedEvent identifica l'evento indirizzato a Tapped al sistema eventi.

Per la maggior parte degli usi del codice dell'app, è sufficiente fare riferimento all'evento in base al nome in XAML o al relativo nome dell'entità di codice nel codice è tutto ciò necessario per fare riferimento a un evento in un oggetto, a scopo di aggiunta o rimozione di gestori. Gli RoutedEvent identificatori sono necessari solo quando si allegano gestori che devono essere richiamati anche quando gli eventi indirizzati vengono contrassegnati in precedenza come gestiti dal sistema o dal codice dell'app. L'API usata per questo scenario e l'API che usa un RoutedEvent valore come parametro, sono UIElement.AddHandler e UIElement.RemoveHandler. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.

Eventi che usano un identificatore RoutedEvent

Ecco un elenco degli eventi indirizzati che hanno un RoutedEvent identificatore e quindi possono usare la tecnica UIElement.AddHandler descritta:

Nota

GotFocus e LostFocus agiscono come eventi indirizzati, ma non hanno un RoutedEvent identificatore, quindi non è possibile usare AddHandler con loro.

Si applica a

Vedi anche