Compartilhar via


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

Recupera uma cadeia de caracteres localizada que descreve o efeito que ocorre quando o usuário descarta o elemento capturado nesse destino de soltar.

Esta propriedade é somente para leitura.

Sintaxe

HRESULT get_DropTargetEffect(
  BSTR *pRetVal
);

Parâmetros

pRetVal

Valor retornado

Nenhum

Comentários

Essa propriedade descreve o efeito padrão que ocorre quando o usuário solta um elemento capturado em um destino, como mover ou copiar o elemento. Essa propriedade pode ser uma cadeia de caracteres curta, como "mover", ou uma mais longa, como "inserir no grupo principal". A cadeia de caracteres sempre é localizada.

Se essa propriedade for alterada, o provedor deverá notificar os clientes disparando um evento UIA_AutomationPropertyChangedEventId .

Exemplos

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (include UIAutomation.h)

Confira também

IDropTargetProvider