Méthode IDropTargetProvider ::get_DropTargetEffect (uiautomationcore.h)

Récupère une chaîne localisée qui décrit l’effet qui se produit lorsque l’utilisateur supprime l’élément saisi sur cette cible de suppression.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_DropTargetEffect(
  BSTR *pRetVal
);

Paramètres

pRetVal

Valeur de retour

None

Remarques

Cette propriété décrit l’effet par défaut qui se produit lorsque l’utilisateur supprime un élément saisi sur une cible, comme le déplacement ou la copie de l’élément. Cette propriété peut être une chaîne courte, telle que « move », ou une plus longue telle que « insérer dans le groupe principal ». La chaîne est toujours localisée.

Si cette propriété change, le fournisseur doit avertir les clients en déclençant un événement UIA_AutomationPropertyChangedEventId .

Exemples

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

IDropTargetProvider