Internetové klávesové zkratky
Objekt zástupce na internetu slouží k vytváření klávesových zkratek na internetové weby. Stejně jako klávesové zkratky k položkám v systému souborů mají zástupci internetu podobu ikony na ploše. Když uživatel klikne na ikonu, prohlížeč se spustí a zobrazí web přidružený ke zkratce.
Probírají se následující témata.
- vytváření internetových zkratek
- přístup k úložiště vlastností
-
rozhraní
- rozhraní OLE
- rozhraní prostředí
- Functions
Vytváření internetových zkratek
Zástupce na internetu můžete vytvořit pomocí ovládacího prvku WebBrowser nebo s adresou URL stránky.
Vytvoření zástupce internetu z ovládacího prvku WebBrowser
Pokud vaše aplikace hostuje ovládací prvek WebBrowser, můžete pomocí objektu zástupce na internetu vytvořit zástupce následujícím způsobem.
- Vytvořte instanci objektu zástupce internetu s CoCreateInstancepomocí identifikátoru třídy (CLSID) CLSID_InternetShortcut.
- Předejte ukazatel na webBrowser IUnknown rozhraní do objektu zástupce internetu s IObjectWithSite::SetSite.
- Volání objektu zástupce internetu IPersistFile::Save metoda, když chcete vytvořit zástupce stránky, kterou zobrazuje ovládací prvek WebBrowser.
Zástupce bude vytvořen v umístění zadaném v IPersistFile::Save. Toto umístění umožňuje ovládacímu prvku WebBrowser obnovit jeho stav, který zahrnuje úlohu načítání správných dokumentů do sad rámců.
Vytvoření zástupce v internetu z adresy URL
Můžete také vytvořit zástupce na internetu, pokud máte adresu URL stránky, na kterou chcete vytvořit odkaz.
- Vytvořte instanci objektu zástupce internetu s CoCreateInstancepomocí CLSID CLSID_InternetShortcut.
- K nastavení adresy URL v zástupce použijte metodu IUniformResourceLocator::SetURL.
- Pomocí metody IPersistFile::Save uložte soubor zástupce do požadovaného umístění.
Přístup k úložišti vlastností
Internetový objekt zástupce obsahuje několik vlastností, ke kterým můžete přistupovat prostřednictvím IPropertySetStorage rozhraní s následujícím postupem.
- Získejte rozhraní IPropertySetStorage voláním QueryInterface pomocí IID_IPropertySetStorage.
- Přejděte k úložišti vlastností zástupce internetu voláním IPropertySetStorage::Open s FMTID_Intshcut nebo FMTID_InternetSite získat IPropertyStorage rozhraní.
- Přečtěte si informace o úložišti vlastností s IPropertyStorage::ReadMultiple předáním příslušného ID vlastnosti.
S verze 4.70 nebo vyšší Shell32.dllmůžete také načíst rozhraní IPropertySetStorage voláním IShellFolder::BindToStorage s parametrem pidl nastaveným na hodnotu . Soubor URL a parametr riid nastavený na IID_IPropertySetStorage.
Pro FMTID_Intshcut je možné vyžádat následující ID vlastností.
PROPID | Typ varianty | Popis |
---|---|---|
PID_IS_URL | VT_LPWSTR | Adresa URL, na kterou zástupce vede |
PID_IS_NAME | VT_LPWSTR | Název zástupce na internetu |
PID_IS_WORKINGDIR | VT_LPWSTR | Pracovní adresář pro zástupce |
PID_IS_HOTKEY | VT_UI2 | Klávesová zkratka pro zástupce |
PID_IS_SHOWCMD | VT_I4 | Zobrazit příkaz pro zástupce |
PID_IS_ICONINDEX | VT_I4 | Index ikony |
PID_IS_ICONFILE | VT_LPWSTR | Soubor obsahující ikonu |
PID_IS_WHATSNEW | VT_LPWSTR | Text Co je nového |
PID_IS_AUTHOR | VT_LPWSTR | Autor |
PID_IS_DESCRIPTION | VT_LPWSTR | Popis textu webu |
PID_IS_COMMENT | VT_LPWSTR | Komentář s poznámkami uživatele |
PID_IS_ROAMED | VT_BOOL | True when shortcut is roamed for first time |
Pro FMTID_InternetSite je možné vyžádat následující ID vlastností.
PROPID | Typ varianty | Popis |
---|---|---|
PID_INTSITE_WHATSNEW | VT_LPWSTR | Text Co je nového |
PID_INTSITE_AUTHOR | VT_LPWSTR | Autor |
PID_INTSITE_LASTVISIT | VT_FILETIME | Čas posledního navštívení webu |
PID_INTSITE_LASTMOD | VT_FILETIME | Čas poslední změny webu |
PID_INTSITE_VISITCOUNT | VT_UI4 | Počet navštívených uživatelů |
PID_INTSITE_DESCRIPTION | VT_LPWSTR | Popis textu webu |
PID_INTSITE_COMMENT | VT_LPWSTR | Komentář s poznámkami uživatele |
PID_INTSITE_FLAGS | VT_UI4 | Označuje použití příznaků PIDISF_ (viz níže). |
PID_INTSITE_CONTENTLEN | Není k dispozici | Aktuálně se nepodporuje. |
PID_INTSITE_CONTENTCODE | Není k dispozici | Aktuálně se nepodporuje. |
PID_INTSITE_RECURSE | Není k dispozici | Aktuálně se nepodporuje. |
PID_INTSITE_WATCH | Není k dispozici | Aktuálně se nepodporuje. |
PID_INTSITE_SUBSCRIPTION | VT_UI8 | Hodnota SUBSCRIPTIONCOOKIE pro správce předplatného |
PID_INTSITE_URL | VT_LPWSTR | Adresa URL, na kterou zástupce vede |
PID_INTSITE_TITLE | VT_LPWSTR | Titul |
PID_INTSITE_CODEPAGE | VT_UI4 | Znaková stránka dokumentu |
PID_INTSITE_TRACKING | Není k dispozici | Aktuálně se nepodporuje. |
PID_INTSITE_ICONINDEX | VT_I4 | Index ikony |
PID_INTSITE_ICONFILE | VT_LPWSTR | Soubor obsahující ikonu |
PID_INTSITE_ROAMED | VT_UI4 | Položka byla přidána z důvodu roamingu. |
Následují příznaky internetových webů.
Vlajka | Popis |
---|---|
PIDISF_RECENTLYCHANGED | Označuje, že se web nedávno změnil. |
PIDISF_CACHEDSTICKY | Aktuálně se nepodporuje. |
PIDISF_CACHEIMAGES | Aktuálně se nepodporuje. |
PIDISF_FOLLOWALLLINKS | Aktuálně se nepodporuje. |
Následující hodnoty se používají pro historii internetového roamingu.
Hodnota PID_INTSITE_ROAMED | Popis |
---|---|
Hodnota není nastavená nebo PIDISR_UP_TO_DATE | Tato položka mezipaměti nebyla upravena roamingem. |
PIDISR_NEEDS_ADD | Tato položka mezipaměti byla přidána do mezipaměti roamingem. Po dokončení zpracování položky nastavte PIDISR_UP_TO_DATE. |
PIDISR_NEEDS_UPDATE | Tato položka mezipaměti již na místním počítači existovala, ale byla aktualizována roamingem. Po dokončení zpracování položky nastavte PIDISR_UP_TO_DATE. |
PIDISR_NEEDS_DELETE | Roaming zjistil, že by se tato položka mezipaměti měla odstranit. Uživatel například vymaže jeho historii prohlížeče. Odstraňte položku pomocí DeleteUrlCacheEntry. |
Rozhraní
Internetový objekt zástupce zveřejňuje řadu rozhraní.
Rozhraní OLE
- IDataObject
- IPersistFile
- IPersistStream
- IOleCommandTarget
- IPropertySetStorage
- IObjectWithSite
Rozhraní prostředí
- IContextMenu2
- IExtractIcon
- INewShortcutHook
- IShellExtInit
- IShellLink
- IShellPropSheetExt
- IQueryInfo
Funkce
Existuje několik pomocných funkcí, které lze použít s objektem zástupce internetu.
Internetové klávesové zkratky – funkce
- InetIsOffline
- MIMEAssociationDialog
- translateURL
- URLAssociationDialog