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)

另請參閱

IDropTargetProvider