共用方式為


IAccessible::get_accHelpTopic 方法 (oleacc.h)

IAccessible::get_accHelpTopic 方法會擷取與指定對象相關聯之 WinHelp 檔案的完整路徑;它也會擷取該檔案中適當主題的標識碼。 並非所有物件都支援這個屬性。 應用程式很少支援或使用此屬性

注意IAccessible::get_accHelpTopic 已被取代,不應使用。
 

語法

HRESULT get_accHelpTopic(
  [out] BSTR    *pszHelpFile,
  [in]  VARIANT varChild,
        long    *pidTopic
);

參數

[out] pszHelpFile

類型: BSTR*

BSTR 的位址,接收與指定對象相關聯之 WinHelp 檔案的完整路徑。

[in] varChild

類型: VARIANT

指定擷取的說明主題是否屬於物件或其中一個物件的子專案。 此參數CHILDID_SELF (取得对象) 的說明主題或子標識碼 (,以取得) 其中一個物件的子元素的 [說明] 主題。 如需初始化 VARIANT 的詳細資訊,請參閱 參數中使用子標識碼的方式

pidTopic

類型: long*

[out, retval]識別與指定對象相關聯之說明檔主題的變數位址。 此值會當做傳遞至 WinHelp 函式之所需主題的內容標識碼使用。 呼叫 WinHelp 以顯示主題時,請將 uCommand 參數設定為 HELP_CONTEXT、將 pidTopic 指向的值轉換為 DWORD,並將它當做 dwData 參數傳遞。

傳回值

類型: HRESULT

如果成功,則傳回 S_OK。

如果未成功,則傳回下表中的其中一個值,或另一個標準 COM 錯誤碼。 伺服器會傳回這些值,但客戶端必須一律檢查輸出參數,以確保它們包含有效的值。 如需詳細資訊,請參閱 檢查 IAccessible 傳回值

錯誤 Description
S_FALSE
沒有可用的說明資訊。
E_INVALIDARG
引數無效。
DISP_E_MEMBERNOTFOUND
物件不支援這個屬性。

備註

從說明檔取得資訊可能需要大量時間和記憶體。

伺服器開發人員的注意事項: 此屬性提供 WinHelp 中幫助主題的存取權, 而 IAccessible::get_accHelp 會傳回字串。 物件不需要同時支援 IAccessible::get_accHelpIAccessible::get_accHelpTopic,但必須至少支援一個。 如果它們可以輕鬆地傳回字串,則必須支援 IAccessible::get_accHelp;否則,他們必須支援 IAccessible::get_accHelpTopic。 如果支援這兩者, IAccessible::get_accHelpTopic 會提供更詳細的資訊。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 oleacc.h
程式庫 Oleacc.lib
Dll Oleacc.dll
可轉散發套件 sp6 和更新版本和 Windows 95 Windows NT 4.0 上的 Active Accessibility 1.3 RDK

另請參閱

HelpTopic 屬性

IAccessible

IAccessible::get_accHelp