IDropTargetProvider::get_DropTargetEffect-Methode (uiautomationcore.h)

Artikel
08/26/2023

Ruft eine lokalisierte Zeichenfolge ab, die den Effekt beschreibt, der auftritt, wenn der Benutzer das erfasste Element auf diesem Ablageziel abwirft.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_DropTargetEffect(
  BSTR *pRetVal
);

Parameter

pRetVal

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft beschreibt den Standardeffekt, der auftritt, wenn der Benutzer ein erfasstes Element auf einem Ziel abwirft, z. B. das Verschieben oder Kopieren des Elements. Bei dieser Eigenschaft kann es sich um eine kurze Zeichenfolge wie "move" oder um eine längere Zeichenfolge wie "in Maingruppe einfügen" handeln. Die Zeichenfolge wird immer lokalisiert.

Wenn sich diese Eigenschaft ändert, muss der Anbieter Clients benachrichtigen, indem er ein UIA_AutomationPropertyChangedEventId-Ereignis auslöst.

Beispiele

IFACEMETHODIMP CRegionProvider::get_DropTargetEffect(BSTR * pDefaultDropAction)
{
    WCHAR wszDropAction[100];
    LoadString(g_hInstance, IDS_REGION_DEFAULTDROPACTION1, wszDropAction, 
        ARRAYSIZE(wszDropAction));
    *pDefaultDropAction = ::SysAllocString(wszDropAction);
    return (*pDefaultDropAction == nullptr) ? E_OUTOFMEMORY : S_OK;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (uiAutomation.h einschließen)

Weitere Informationen

IDropTargetProvider

Freigeben über