Функция CreateStdAccessibleProxyW (oleacc.h)
Создает объект со специальными возможностями, который содержит свойства и методы указанного класса элемента пользовательского интерфейса, предоставляемого системой.
Синтаксис
HRESULT CreateStdAccessibleProxyW(
[in] HWND hwnd,
[in] LPCWSTR pClassName,
[in] LONG idObject,
[in] REFIID riid,
[out] void **ppvObject
);
Параметры
[in] hwnd
Тип: HWND
Дескриптор окна предоставленного системой элемента пользовательского интерфейса (элемента управления), для которого создается объект со специальными возможностями.
[in] pClassName
Тип: LPCTSTR
Указатель на строку, завершающуюся нулевым значением, имя класса предоставленного системой элемента пользовательского интерфейса, для которого создается объект со специальными возможностями. Имя класса окна — это один из общих элементов управления (определенных в Comctl32.dll), предопределенных элементов управления (определенных в User32.dll) или оконных элементов.
[in] idObject
Тип: LONG
Идентификатор объекта. Это значение обычно OBJID_CLIENT, которое является одной из констант идентификатора объекта, но может быть другим идентификатором объекта.
[in] riid
Тип: REFIID
Идентификатор ссылки запрошенного интерфейса. Это одно из следующих значений: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT или IID_IUnknown.
[out] ppvObject
Тип: void**
Адрес переменной указателя, которая получает адрес указанного интерфейса.
Возвращаемое значение
Тип: STDAPI
Возвращает значение S_OK, если операция завершилась успешно.
В случае успеха возвращает стандартный код ошибки COM.
Комментарии
Серверные приложения вызывают эту функцию, если они содержат пользовательский элемент управления, аналогичный системным. Серверные приложения могут вызывать CreateStdAccessibleProxy , чтобы переопределить методы и свойства IAccessible в соответствии с требованиями к их пользовательским элементам управления. Кроме того, разработчики серверов могут использовать динамическую заметку для переопределения определенных свойств без использования сложных методов подклассов, необходимых для CreateStdAccessibleProxy. Разработчики серверов по-прежнему должны использовать CreateStdAccessibleProxy для структурных изменений, таких как скрытие дочернего элемента или создание заполнителя дочернего элемента. Такой подход позволяет разработчикам серверов полностью реализовать все свойства и методы IAccessible .
Эта функция похожа на CreateStdAccessibleObject, за исключением того, что CreateStdAccessibleObject всегда использует имя класса, связанное с hwnd , тогда как CreateStdAccessibleProxy позволяет указать имя класса в качестве параметра.
Используйте CreateStdAccessibleProxy , чтобы создать объект со специальными возможностями для элемента пользовательского интерфейса, который является суперклассом. Когда элемент пользовательского интерфейса является суперклассом, приложение создает пользовательский элемент управления с именем класса окна, отличным от предопределенного элемента управления, на котором он основан. Так как имя класса, связанное с параметром hwnd , является именем класса окна суперкласса, укажите имя базового класса (имя системного класса, на котором основан надклассовый элемент управления) в pszClassName.
Примечание
Заголовок oleacc.h определяет CreateStdAccessibleProxy в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | 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 |
См. также раздел
Приложение А. Справочник по поддерживаемым элементам пользовательского интерфейса
Ярлыки для предоставления пользовательских элементов пользовательского интерфейса