Метод IAccessible::get_accDefaultAction (oleacc.h)

Статья
08/25/2023

Метод IAccessible::get_accDefaultAction извлекает строку, указывающую действие объекта по умолчанию. Не все объекты имеют действия по умолчанию.

Синтаксис

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

Параметры

[in] varChild

Тип: VARIANT

Указывает, выполняется ли полученное действие по умолчанию объектом или одним из дочерних элементов объекта. Этот параметр CHILDID_SELF (для получения сведений об объекте) или идентификатор дочернего элемента (для получения сведений о дочернем элементе объекта). Дополнительные сведения об инициализации структуры VARIANT см. в разделе Использование дочерних идентификаторов в параметрах.

[out, retval] pszDefaultAction

Тип: BSTR*

Адрес BSTR , получающий локализованную строку, описывающую действие по умолчанию для указанного объекта; Если у этого объекта нет действия по умолчанию, значение равно NULL.

Возвращаемое значение

Тип: HRESULT

Возвращает значение S_OK, если операция завершилась успешно.

В противном случае возвращает одно из значений в следующей таблице или другой стандартный код ошибки COM. Серверы возвращают эти значения, но клиенты должны всегда проверка выходные параметры, чтобы убедиться, что они содержат допустимые значения. Дополнительные сведения см. в разделе Проверка возвращаемых значений IAccessible.

Ошибка	Описание
S_FALSE	Указанный объект не имеет действия по умолчанию.
E_INVALIDARG	Аргумент является недопустимым.
DISP_E_MEMBERNOTFOUND	Указанный объект не поддерживает это свойство.

Полученная строка описывает действие, выполняемое с объектом, а не то, что объект делает в результате. Например, кнопка панели инструментов, которая печатает документ, имеет действие по умолчанию "Нажмите", а не "Печать текущего документа".

Не путайте действие объекта по умолчанию со значением. Дополнительные сведения см. в разделе Свойство DefaultAction.

Этот метод поддерживают только элементы управления, выполняющие действия.

Обратите внимание на серверные разработчики: Локализация строки, возвращаемой из этого свойства.

Пример сервера

В следующем примере кода показана возможная реализация этого метода для настраиваемого списка. Для простоты строки не локализованы.


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

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	oleacc.h
Библиотека	Oleacc.lib
DLL	Oleacc.dll
Распространяемые компоненты	Активные специальные возможности 1.3 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 95

См. также раздел

Свойство DefaultAction

IAccessible

IAccessible::accDoDefaultAction

ВАРИАНТ