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

Article
03/06/2024

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

Partager via