IXamlDirect.AddEventHandler Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| AddEventHandler(Object, XamlEventIndex, Object) |
Ajoute le gestionnaire d’événements spécifié pour un événement spécifié à l’aide de XamlEventIndex, en ajoutant le gestionnaire à la collection de gestionnaires sur l’objet spécifié. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). |
| AddEventHandler(Object, XamlEventIndex, Object, Boolean) |
Ajoute le gestionnaire d’événements spécifié pour un événement spécifié à l’aide de XamlEventIndex, en ajoutant le gestionnaire à la collection de gestionnaires sur l’IXamlDirect actuel. Spécifiez handledEventsToo comme vrai pour que le gestionnaire fourni soit appelé même si l’événement est géré ailleurs. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). |
AddEventHandler(Object, XamlEventIndex, Object)
Ajoute le gestionnaire d’événements spécifié pour un événement spécifié à l’aide de XamlEventIndex, en ajoutant le gestionnaire à la collection de gestionnaires sur l’objet spécifié.
Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
public:
void AddEventHandler(Platform::Object ^ xamlDirectObject, XamlEventIndex eventIndex, Platform::Object ^ handler);/// [Windows.Foundation.Metadata.Overload("AddEventHandler2")]
void AddEventHandler(IInspectable const& xamlDirectObject, XamlEventIndex const& eventIndex, IInspectable const& handler);[Windows.Foundation.Metadata.Overload("AddEventHandler2")]
public void AddEventHandler(object xamlDirectObject, XamlEventIndex eventIndex, object handler);Public Sub AddEventHandler (xamlDirectObject As Object, eventIndex As XamlEventIndex, handler As Object)Paramètres
- xamlDirectObject
-
Object
Platform::Object
IInspectable
Référence à l’objet qui reçoit le gestionnaire d’événements.
- eventIndex
- XamlEventIndex
Identificateur de l’événement à gérer via l’énumération XamlEventIndex .
- handler
-
Object
Platform::Object
IInspectable
Référence à l’implémentation de gestionnaire spécifiée.
- Attributs
Exemples
L’exemple suivant montre comment ajouter/modifier l’événement PointerEntered via une instance spécifique de PointerEventHandler sur un contrôle ToggleSwitch à partir de son instance IXamlDirect .
XamlDirect xd = XamlDirect.GetDefault();
IXamlDirect toggleSwitch = xd.CreateInstance(XamlTypeIndex.ToggleSwitch);
PointerEventHandler toggleSwitchPointerHandler = new PointerEventHandler((sender, args) =>
{
if (sender is ToggleSwitch)
{
((ToggleSwitch)sender).IsOn = !((ToggleSwitch)sender).IsOn;
}
});
xd.AddEventHandler(toggleSwitch, XamlEventIndex.UIElement_PointerEntered, toggleSwitchPointerHandler);
XamlDirect^ xd = XamlDirect::GetDefault();
IXamlDirect^ toggleSwitch = xd->CreateInstance(XamlTypeIndex::ToggleSwitch);
PointerEventHandler^ toggleSwitchPointerHandler = ref new PointerEventHandler([&](Platform::Object^ sender, PointerRoutedEventArgs^ args)
{
ToggleSwitch^ ts = dynamic_cast<ToggleSwitch^>(sender);
if (nullptr != ts)
{
ts->IsOn = !ts->IsOn;
}
});
xd->AddEventHandler(toggleSwitch, XamlEventIndex::UIElement_PointerEntered, toggleSwitchPointerHandler);
Remarques
AddEventHandler ne peut être utilisé que pour ajouter des gestionnaires d’événements pour les événements pris en charge par l’énumération XamlEventIndex . Vous pouvez utiliser cette méthode pour ajouter des gestionnaires à des événements routés et non routés pris en charge par l’objet xaml.
Voir aussi
- AddEventHandler(Object, XamlEventIndex, Object, Boolean)
- RemoveEventHandler(Object, XamlEventIndex, Object)
S’applique à
AddEventHandler(Object, XamlEventIndex, Object, Boolean)
Ajoute le gestionnaire d’événements spécifié pour un événement spécifié à l’aide de XamlEventIndex, en ajoutant le gestionnaire à la collection de gestionnaires sur l’IXamlDirect actuel. Spécifiez handledEventsToo comme vrai pour que le gestionnaire fourni soit appelé même si l’événement est géré ailleurs.
Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
public:
void AddEventHandler(Platform::Object ^ xamlDirectObject, XamlEventIndex eventIndex, Platform::Object ^ handler, bool handledEventsToo);/// [Windows.Foundation.Metadata.Overload("AddEventHandler1")]
void AddEventHandler(IInspectable const& xamlDirectObject, XamlEventIndex const& eventIndex, IInspectable const& handler, bool const& handledEventsToo);[Windows.Foundation.Metadata.Overload("AddEventHandler1")]
public void AddEventHandler(object xamlDirectObject, XamlEventIndex eventIndex, object handler, bool handledEventsToo);Public Sub AddEventHandler (xamlDirectObject As Object, eventIndex As XamlEventIndex, handler As Object, handledEventsToo As Boolean)Paramètres
- xamlDirectObject
-
Object
Platform::Object
IInspectable
Référence à L’IXamlDirect actuel.
- eventIndex
- XamlEventIndex
Identificateur de l’événement à gérer via l’énumération XamlEventIndex .
- handler
-
Object
Platform::Object
IInspectable
Référence à l’implémentation de gestionnaire spécifiée.
- handledEventsToo
-
Boolean
bool
true pour inscrire le gestionnaire de sorte qu’il soit appelé même lorsque l’événement routé est marqué dans ses données d’événement.
false pour inscrire le gestionnaire avec la condition par défaut qu’il n’est pas appelé si l’événement routé est déjà marqué.
La valeur par défaut est false et le paramètre est facultatif.
- Attributs
Exemples
XamlDirect xd = XamlDirect.GetDefault();
IXamlDirect toggleSwitch = xd.CreateInstance(XamlTypeIndex.ToggleSwitch);
PointerEventHandler toggleSwitchPointerHandler = new PointerEventHandler((sender, args) =>
{
if (sender is ToggleSwitch)
{
((ToggleSwitch)sender).IsOn = !((ToggleSwitch)sender).IsOn;
}
});
xd.AddEventHandler(toggleSwitch, XamlEventIndex.UIElement_PointerEntered, toggleSwitchPointerHandler, true);
XamlDirect^ xd = XamlDirect::GetDefault();
IXamlDirect^ toggleSwitch = xd->CreateInstance(XamlTypeIndex::ToggleSwitch);
PointerEventHandler^ toggleSwitchPointerHandler = ref new PointerEventHandler([&](Platform::Object^ sender, PointerRoutedEventArgs^ args)
{
ToggleSwitch^ ts = dynamic_cast<ToggleSwitch^>(sender);
if (nullptr != ts)
{
ts->IsOn = !ts->IsOn;
}
});
xd->AddEventHandler(toggleSwitch, XamlEventIndex::UIElement_PointerEntered, toggleSwitchPointerHandler, true);
Remarques
AddEventHandler ne peut être utilisé que pour ajouter des gestionnaires d’événements pour les événements pris en charge par l’énumération XamlEventIndex . Vous pouvez utiliser cette méthode pour ajouter des gestionnaires à des événements routés et non routés pris en charge par l’objet xaml.
Consultez UIElement.AddHandler pour savoir quand utiliser handledEventsToo et les restrictions autour du même. Pour les événements non routés, l’indicateur handleEventsToo est complètement ignoré.
Voir aussi
- AddEventHandler(Object, XamlEventIndex, Object)
- RemoveEventHandler(Object, XamlEventIndex, Object)
- UIElement.AddHandler
- UIElement.RemoveHandler