共用方式為


CreateStdAccessibleProxyA 函式 (oleacc.h)

建立可存取的物件,此物件具有系統提供之使用者介面元素之指定類別的屬性和方法。

語法

HRESULT CreateStdAccessibleProxyA(
  [in]  HWND   hwnd,
  [in]  LPCSTR pClassName,
  [in]  LONG   idObject,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

參數

[in] hwnd

類型:HWND

系統提供之使用者介面專案(控件)的視窗句柄,其中會建立可存取的物件。

[in] pClassName

類型:LPCTSTR

建立可存取物件之系統提供之使用者介面項目類別名稱之 Null 終止字串的指標。 視窗類別名稱是其中一個通用控件(定義於 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 參數相關聯的類別名稱是 superclass 視窗類別名稱,因此請在 pszClassName中指定基類名稱(超級類別化控件所依據的系統類別名稱)。

注意

oleacc.h 標頭會根據 UNICODE 預處理器常數的定義,將 CreateStdAccessibleProxy 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 oleacc.h
連結庫 Oleacc.lib
DLL Oleacc.dll
可轉散發 Windows NT 4.0 和更新版本和 Windows 95 上的 Active Accessibility 1.3 RDK

另請參閱

附錄 A:支援的使用者介面元素參考

CreateStdAccessibleObject

IDispatch

用來公開自定義使用者介面專案的快捷方式