IObjectWithAppUserModelID 介面 (shobjidl_core.h)
公開方法,允許自定義 IAssocHandler 對象的實作者存取其明確的應用程式使用者模型識別碼 (AppUserModelID) 。 這項資訊可用來判斷特定檔類型是否可以新增至應用程式的跳躍清單。
繼承
IObjectWithAppUserModelID 介面繼承自 IUnknown 介面。 IObjectWithAppUserModelID 也有下列類型的成員:
方法
IObjectWithAppUserModelID 介面具有這些方法。
IObjectWithAppUserModelID::GetAppID 如果已宣告檔類型處理程式的明確應用程式使用者模型標識符, (AppUserModelID) 擷取檔類型處理程式。 |
IObjectWithAppUserModelID::SetAppID 指定唯一的應用程式定義應用程式使用者模型標識碼 (AppUserModelID) ,將對象識別為特定檔類型的處理程式。 需要動態AppUserModelID的應用程式會使用這個方法。 |
備註
只有應用程式是已註冊處理程式的檔類型才會出現在該應用程式的跳躍清單中。 當應用程式使用明確的 AppUserModelID 來識別本身及其所屬的視窗和進程時,該 AppUserModelID 也必須在處理程式的實作中設定,以便將處理程式辨識為與該應用程式相關聯。 當應用程式存取這類 SHAddToRecentDocs 的檔案時,會嘗試將檔案新增至該應用程式的 [ 最近 ] 或 [ 經常 ] 類別,或可能是該應用程式的 [跳躍清單] 中的自定義類別。 如果應用程式是該檔類型的已註冊處理程式,則由處理程式的AppUserModelID符合應用程式的AppUserModelID識別,該檔案會新增至跳躍清單。 如果沒有,則會篩選它,而且不會出現。
實作時機
此介面的實作會在 Windows 中提供。 建立自定義 Shell 資料夾的應用程式,這些資料夾會公開系統所需的關聯處理程式列舉,以判斷應用程式快捷方式清單中允許的檔案應該實作自己的版本。使用時機
只有在您的應用程式使用明確的 AppUserModelID 時,才需要此物件。 如果沒有明確公開的 AppUserModelID,就不需要此物件。IObjectWithAppUserModelID 一律會做為使用明確 AppUserModelID 且想要將該資訊公開給系統的較大型物件的一部分。
系統會呼叫處理程式上實作的 IObjectWithAppUserModelID::GetAppID 方法,以判斷應用程式是否為檔類型的已註冊處理程式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包括 Shobjidl.h) |