Метод IDropTargetProvider::get_DropTargetEffect (uiautomationcore.h)

Статья
08/26/2023

Извлекает локализованную строку, описывающую эффект, который происходит, когда пользователь удаляет захваченный элемент в этот целевой объект удаления.

Это свойство доступно только для чтения.

Синтаксис

HRESULT get_DropTargetEffect(
  BSTR *pRetVal
);

Параметры

pRetVal

Возвращаемое значение

None

Remarks

Это свойство описывает эффект по умолчанию, который происходит при удалении пользователем захваченного элемента на целевой объект, например при перемещении или копировании элемента. Это свойство может быть короткой строкой, например "переместить", или более длинной строкой, например "вставка в группу 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
Header	uiautomationcore.h (включая UIAutomation.h)

См. также раздел

IDropTargetProvider

Поделиться через