Método IAccessible::get_accDefaultAction (oleacc.h)

O método IAccessible::get_accDefaultAction recupera uma cadeia de caracteres que indica a ação padrão do objeto. Nem todos os objetos têm uma ação padrão.

Sintaxe

HRESULT get_accDefaultAction(
  [in]          VARIANT varChild,
  [out, retval] BSTR    *pszDefaultAction
);

Parâmetros

[in] varChild

Tipo: VARIANT

Especifica se a ação padrão recuperada é executada pelo objeto ou por um dos elementos filho do objeto. Esse parâmetro é CHILDID_SELF (para obter informações sobre o objeto) ou uma ID filho (para obter informações sobre o elemento filho do objeto). Para obter mais informações sobre como inicializar a estrutura VARIANT, consulte Como as IDs filho são usadas em parâmetros.

[out, retval] pszDefaultAction

Tipo: BSTR*

Endereço de um BSTR que recebe uma cadeia de caracteres localizada que descreve a ação padrão para o objeto especificado; se esse objeto não tiver nenhuma ação padrão, o valor será NULL.

Valor retornado

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará um dos valores na tabela a seguir ou outro código de erro COM padrão. Os servidores retornam esses valores, mas os clientes devem sempre marcar parâmetros de saída para garantir que eles contenham valores válidos. Para obter mais informações, consulte Verificando valores retornados IAccessible.

Erro	Descrição
S_FALSE	O objeto especificado não tem uma ação padrão.
E_INVALIDARG	Um argumento não é válido.
DISP_E_MEMBERNOTFOUND	O objeto especificado não dá suporte a essa propriedade.

Comentários

A cadeia de caracteres recuperada descreve a ação executada em um objeto, não o que o objeto faz como resultado. Por exemplo, um botão de barra de ferramentas que imprime um documento tem uma ação padrão de "Pressionar" em vez de "Imprimir o documento atual".

Não confunda a ação padrão de um objeto com seu valor. Para obter mais informações, consulte Propriedade DefaultAction.

Somente os controles que executam ações dão suporte a esse método.

Observação para desenvolvedores de servidores: Localize a cadeia de caracteres retornada dessa propriedade.

Exemplo de servidor

O código de exemplo a seguir mostra uma possível implementação desse método para uma caixa de listagem personalizada. Para simplificar, as cadeias de caracteres não são localizadas.

HRESULT STDMETHODCALLTYPE AccServer::get_accDefaultAction( 
    VARIANT varChild,
    BSTR *pszDefaultAction)
{
    if (varChild.vt != VT_I4)
    {
        *pszDefaultAction = NULL;
        return E_INVALIDARG;
    }
    if (varChild.lVal == CHILDID_SELF)
    {
        *pszDefaultAction = SysAllocString(L"None.");
    }
    else
    {
        *pszDefaultAction = SysAllocString(L"Double-click");
    }
    return S_OK;
};

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleacc.h
Biblioteca	Oleacc.lib
DLL	Oleacc.dll
Redistribuível	Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95

Confira também

Propriedade DefaultAction

Iaccessible

IAccessible::accDoDefaultAction

VARIANT