Metodo IAccessible::get_accDefaultAction (oleacc.h)
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 |
|---|---|
|
L'oggetto specificato non dispone di un'azione predefinita. |
|
Un argomento non è valido. |
|
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 |