Metodo IAccessible::get_accDefaultAction (oleacc.h)

Articolo
08/25/2023

Il metodo IAccessible::get_accDefaultAction recupera una stringa che indica l'azione predefinita dell'oggetto. Non a tutti gli oggetti è associata un'azione predefinita.

Sintassi

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

Parametri

[in] varChild

Tipo: VARIANT

Specifica se l'azione predefinita recuperata viene eseguita dall'oggetto o da uno degli elementi figlio dell'oggetto. Questo parametro è CHILDID_SELF (per ottenere informazioni sull'oggetto) o un ID figlio (per ottenere informazioni sull'elemento figlio dell'oggetto). Per altre informazioni sull'inizializzazione della struttura VARIANT, vedere Modalità di utilizzo degli ID figlio nei parametri.

[out, retval] pszDefaultAction

Tipo: BSTR*

Indirizzo di una stringa BSTR che riceve una stringa localizzata che descrive l'azione predefinita per l'oggetto specificato; se questo oggetto non ha alcuna azione predefinita, il valore è NULL.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

In caso contrario, restituisce uno dei valori della tabella che segue o un altro codice di errore COM standard. I server restituiscono questi valori, ma i client devono sempre controllare i parametri di output per assicurarsi che contengano valori validi. Per altre informazioni, vedere Controllo dei valori restituiti IAccessible.

Errore	Descrizione
S_FALSE	L'oggetto specificato non dispone di un'azione predefinita.
E_INVALIDARG	Un argomento non è valido.
DISP_E_MEMBERNOTFOUND	L'oggetto specificato non supporta questa proprietà.

Commenti

La stringa recuperata descrive l'azione eseguita su un oggetto, non il risultato dell'oggetto. Ad esempio, un pulsante della barra degli strumenti che stampa un documento ha un'azione predefinita "Premi" anziché "Stampa il documento corrente".

Non confondere l'azione predefinita di un oggetto con il relativo valore. Per altre informazioni, vedere DefaultAction Property.

Solo i controlli che eseguono azioni supportano questo metodo.

Nota per gli sviluppatori di server: Localizzare la stringa restituita da questa proprietà.

Esempio di server

Il codice di esempio seguente mostra una possibile implementazione di questo metodo per una casella di riepilogo personalizzata. Per semplicità, le stringhe non vengono localizzate.


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

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleacc.h
Libreria	Oleacc.lib
DLL	Oleacc.dll
Componente ridistribuibile	Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95