IDropTargetProvider::get_DropTargetEffect 方法 (uiautomationcore.h)
擷取本地化字串,描述當使用者卸除此置放目標上抓取的元素時所發生的效果。
這個屬性是唯讀的。
語法
HRESULT get_DropTargetEffect(
BSTR *pRetVal
);
參數
pRetVal
傳回值
無
備註
此屬性描述當用戶在目標上卸除抓取元素時所發生的預設效果,例如移動或複製專案。 此屬性可以是簡短字串,例如 「move」,或較長的字串,例如「插入 Main 群組」。 字串一律會本地化。
如果此屬性變更,提供者必須引發 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) |