XamlDirect.AddEventHandler Methode
Definition
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.
Überlädt
| AddEventHandler(IXamlDirectObject, XamlEventIndex, Object) |
Fügt den angegebenen Ereignishandler für ein angegebenes Ereignis mithilfe von XamlEventIndex hinzu, und fügt den Handler der Handlerauflistung auf dem aktuellen IXamlDirectObject hinzu. |
| AddEventHandler(IXamlDirectObject, XamlEventIndex, Object, Boolean) |
Fügt den angegebenen Ereignishandler für ein angegebenes Ereignis mithilfe von XamlEventIndex hinzu, und fügt den Handler der Handlerauflistung auf dem aktuellen IXamlDirectObject hinzu. Geben Sie handledEventsToo als true an, damit der bereitgestellte Handler aufgerufen wird, auch wenn das Ereignis an anderer Stelle behandelt wird. |
AddEventHandler(IXamlDirectObject, XamlEventIndex, Object)
Fügt den angegebenen Ereignishandler für ein angegebenes Ereignis mithilfe von XamlEventIndex hinzu, und fügt den Handler der Handlerauflistung auf dem aktuellen IXamlDirectObject hinzu.
public:
virtual void AddEventHandler(IXamlDirectObject ^ xamlDirectObject, XamlEventIndex eventIndex, Platform::Object ^ handler) = AddEventHandler;/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("AddEventHandler")]
void AddEventHandler(IXamlDirectObject const& xamlDirectObject, XamlEventIndex const& eventIndex, IInspectable const& handler);[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("AddEventHandler")]
public void AddEventHandler(IXamlDirectObject xamlDirectObject, XamlEventIndex eventIndex, object handler);function addEventHandler(xamlDirectObject, eventIndex, handler)Public Sub AddEventHandler (xamlDirectObject As IXamlDirectObject, eventIndex As XamlEventIndex, handler As Object)Parameter
- xamlDirectObject
- IXamlDirectObject
Ein Verweis auf das aktuelle IXamlDirectObject.
- eventIndex
- XamlEventIndex
Ein Bezeichner für das zu behandelnde Ereignis, das über die XamlEventIndex-Enumeration angegeben wird.
- handler
-
Object
Platform::Object
IInspectable
Ein Verweis auf die angegebene Handlerimplementierung.
- Attribute
Beispiele
Im folgenden Beispiel wird gezeigt, wie das PointerEntered-Ereignis über eine bestimmte instance von PointerEventHandler für ein ToggleSwitch-Steuerelement über dessen IXamlDirectObject-instance hinzugefügt/geändert wird.
XamlDirect xd = XamlDirect.GetDefault();
IXamlDirectObject 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();
IXamlDirectObject^ 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);
Hinweise
AddEventHandler kann nur zum Hinzufügen von Ereignishandlern für die von der XamlEventIndex-Enumeration unterstützten Ereignisse verwendet werden. Sie können diese Methode verwenden, um Handler zu weitergeleiteten ereignissen hinzuzufügen, die vom XAML-Objekt unterstützt werden.
Weitere Informationen
- AddEventHandler(IXamlDirectObject, XamlEventIndex, Object, Boolean)
- RemoveEventHandler(IXamlDirectObject, XamlEventIndex, Object)
Gilt für:
AddEventHandler(IXamlDirectObject, XamlEventIndex, Object, Boolean)
Fügt den angegebenen Ereignishandler für ein angegebenes Ereignis mithilfe von XamlEventIndex hinzu, und fügt den Handler der Handlerauflistung auf dem aktuellen IXamlDirectObject hinzu. Geben Sie handledEventsToo als true an, damit der bereitgestellte Handler aufgerufen wird, auch wenn das Ereignis an anderer Stelle behandelt wird.
public:
virtual void AddEventHandler(IXamlDirectObject ^ xamlDirectObject, XamlEventIndex eventIndex, Platform::Object ^ handler, bool handledEventsToo) = AddEventHandler;/// [Windows.Foundation.Metadata.Overload("AddEventHandler_HandledEventsToo")]
void AddEventHandler(IXamlDirectObject const& xamlDirectObject, XamlEventIndex const& eventIndex, IInspectable const& handler, bool const& handledEventsToo);[Windows.Foundation.Metadata.Overload("AddEventHandler_HandledEventsToo")]
public void AddEventHandler(IXamlDirectObject xamlDirectObject, XamlEventIndex eventIndex, object handler, bool handledEventsToo);function addEventHandler(xamlDirectObject, eventIndex, handler, handledEventsToo)Public Sub AddEventHandler (xamlDirectObject As IXamlDirectObject, eventIndex As XamlEventIndex, handler As Object, handledEventsToo As Boolean)Parameter
- xamlDirectObject
- IXamlDirectObject
Ein Verweis auf das aktuelle IXamlDirectObject.
- eventIndex
- XamlEventIndex
Ein Bezeichner für das zu behandelnde Ereignis, das über die XamlEventIndex-Enumeration angegeben wird.
- handler
-
Object
Platform::Object
IInspectable
Ein Verweis auf die angegebene Handlerimplementierung.
- handledEventsToo
-
Boolean
bool
true , um den Handler so zu registrieren, dass er auch dann aufgerufen wird, wenn das routingfähige Ereignis in seinen Ereignisdaten behandelt markiert wird. false , um den Handler mit der Standardbedingung zu registrieren, dass er nicht aufgerufen wird, wenn das Routingereignis bereits als behandelt markiert ist.
Der Standardwert ist false, und der Parameter ist optional.
- Attribute
Beispiele
Im folgenden Beispiel wird gezeigt, wie das PointerEntered-Ereignis über eine bestimmte instance von PointerEventHandler für ein ToggleSwitch-Steuerelement über dessen IXamlDirectObject-instance hinzugefügt/geändert wird.
XamlDirect xd = XamlDirect.GetDefault();
IXamlDirectObject 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();
IXamlDirectObject^ 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);
Hinweise
AddEventHandler kann nur zum Hinzufügen von Ereignishandlern für die von der XamlEventIndex-Enumeration unterstützten Ereignisse verwendet werden. Sie können diese Methode verwenden, um Handler zu weitergeleiteten ereignissen hinzuzufügen, die vom XAML-Objekt unterstützt werden.
Informationen zur Verwendung von handledEventsToo finden Sie unter UIElement.AddHandler und die Einschränkungen rund um dasselbe. Bei nicht weitergeleiteten Ereignissen wird das handleEventsToo-Flag vollständig ignoriert.
Weitere Informationen
- AddEventHandler(IXamlDirectObject, XamlEventIndex, Object)
- RemoveEventHandler(IXamlDirectObject, XamlEventIndex, Object)
- AddHandler(RoutedEvent, Object, Boolean)
- RemoveHandler(RoutedEvent, Object)