IDropTargetProvider::get_DropTargetEffect 方法 (uiautomationcore.h)

检索一个本地化字符串,该字符串描述当用户在此放置目标上放置抓取的元素时发生的效果。

此属性为只读。

语法

HRESULT get_DropTargetEffect(
  BSTR *pRetVal
);

参数

pRetVal

返回值

备注

此属性描述当用户在目标上放置抓取的元素(例如移动或复制元素)时发生的默认效果。 此属性可以是短字符串(如“move”),也可以是较长的字符串,例如“插入到主组”。 字符串始终是本地化的。

如果此属性发生更改,提供程序必须通过触发 UIA_AutomationPropertyChangedEventId 事件来通知客户端。

示例

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;
}

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)

另请参阅

IDropTargetProvider