Metodo IDropTargetProvider::get_DropTargetEffect (uiautomationcore.h)

Articolo
03/03/2024

Recupera una stringa localizzata che descrive l'effetto che si verifica quando l'utente elimina l'elemento afferrato sulla destinazione di rilascio.

Questa proprietà è di sola lettura.

Sintassi

HRESULT get_DropTargetEffect(
  BSTR *pRetVal
);

Parametri

pRetVal

Valore restituito

nessuno

Osservazioni

Questa proprietà descrive l'effetto predefinito che si verifica quando l'utente elimina un elemento afferrato su una destinazione, ad esempio lo spostamento o la copia dell'elemento. Questa proprietà può essere una stringa breve, ad esempio "move" o una più lunga, ad esempio "insert into Main group". La stringa viene sempre localizzata.

Se questa proprietà viene modificata, il provider deve notificare ai client attivando un evento UIA_AutomationPropertyChangedEventId .

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcore.h (include UIAutomation.h)

Vedi anche

IDropTargetProvider

Condividi tramite