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_accHelp 和 IAccessible：：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