Udostępnij przez

Internet Shortcuts

Obiekt skrótów internetowych służy do tworzenia skrótów klasycznych do witryn internetowych. Podobnie jak skróty do elementów w systemie plików, skróty internetowe mają postać ikony na pulpicie. Gdy użytkownik kliknie ikonę, ścieżka adresu URL jest otwierana przez aplikację obsługi, zazwyczaj domyślną przeglądarkę internetową użytkownika.

Omówiono następujące tematy.

Tworzenie skrótów internetowych

Skrót internetowy można utworzyć za pomocą kontrolki WebBrowser lub adresu URL strony.

Tworzenie skrótu internetowego na podstawie kontrolki WebBrowser

Jeśli aplikacja hostuje kontrolkę WebBrowser, możesz użyć obiektu skrótów internetowych, aby utworzyć skróty w następujący sposób.

  1. Utwórz wystąpienie obiektu skrótu internetowego z CoCreateInstance, przy użyciu identyfikatora klasy (CLSID) CLSID_InternetShortcut.
  2. Przekaż wskaźnik do interfejsu IUnknown webBrowser do obiektu skrótów internetowych za pomocą IObjectWithSite::SetSite.
  3. Wywołaj metodę IPersistFile::Save obiektu skrótu internetowego, gdy chcesz utworzyć skrót do strony wyświetlanej przez kontrolkę WebBrowser.

Skrót zostanie utworzony w lokalizacji określonej w IPersistFile::Save. Ta lokalizacja umożliwia kontrolce WebBrowser przywrócenie stanu, co obejmuje zadanie załadowania odpowiednich dokumentów do zestawów ramek.

Tworzenie skrótu internetowego na podstawie adresu URL

Możesz również utworzyć skrót internetowy, jeśli masz adres URL strony, do której chcesz utworzyć łącze.

  1. Utwórz wystąpienie obiektu skrótu internetowego za pomocą CoCreateInstanceprzy użyciu identyfikatora CLSID CLSID_InternetShortcut.
  2. Użyj metody IUniformResourceLocator::SetURL, aby ustawić adres URL w skrócie.
  3. Użyj metody IPersistFile::Save, aby zapisać plik skrótu w żądanej lokalizacji.

Uzyskiwanie dostępu do magazynu właściwości

Obiekt skrótów internetowych zawiera kilka właściwości, do których można uzyskać dostęp za pośrednictwem IPropertySetStorage interfejsu obiektu przy użyciu poniższej procedury.

  1. Pobierz interfejs IPropertySetStorage, wywołując QueryInterface za pomocą IID_IPropertySetStorage.
  2. Uzyskaj dostęp do zestawu właściwości skrótów internetowych, wywołując IPropertySetStorage::Otwórz za pomocą FMTID_Intshcut lub FMTID_InternetSite, aby uzyskać interfejs IPropertyStorage.
  3. Przeczytaj informacje o magazynie właściwości za pomocą IPropertyStorage::ReadMultiple, przekazując odpowiedni identyfikator właściwości.

W w wersji 4.70 lub nowszej Shell32.dllmożna również pobrać interfejs IPropertySetStorage, wywołując IShellFolder::BindToStorage z parametrem pidl ustawionym na wartość . Plik URL i parametr riid ustawiony na IID_IPropertySetStorage.

Dla FMTID_Intshcut można zażądać następujących identyfikatorów właściwości.

PROPID Variant Type Description
PID_IS_URL VT_LPWSTR Adres URL, do którego prowadzi skrót
PID_IS_NAME VT_LPWSTR Nazwa skrótu internetowego
PID_IS_WORKINGDIR VT_LPWSTR Katalog roboczy skrótu
PID_IS_HOTKEY VT_UI2 skrótu
PID_IS_SHOWCMD VT_I4 Pokaż polecenie skrótu
PID_IS_ICONINDEX VT_I4 Indeks ikony
PID_IS_ICONFILE VT_LPWSTR Plik zawierający ikonę
PID_IS_WHATSNEW VT_LPWSTR Co nowego tekstu
PID_IS_AUTHOR VT_LPWSTR Author
PID_IS_DESCRIPTION VT_LPWSTR Tekst opisu witryny
PID_IS_COMMENT VT_LPWSTR Komentarz z adnotacjami użytkownika
PID_IS_ROAMED VT_BOOL Prawda, gdy skrót jest wędrowany po raz pierwszy

 

Dla FMTID_InternetSite można zażądać następujących identyfikatorów właściwości.

PROPID Variant Type Description
PID_INTSITE_WHATSNEW VT_LPWSTR Co nowego tekstu
PID_INTSITE_AUTHOR VT_LPWSTR Author
PID_INTSITE_LASTVISIT VT_FILETIME Strona czasowa została ostatnio odwiedzona
PID_INTSITE_LASTMOD VT_FILETIME Godzina ostatniej modyfikacji witryny
PID_INTSITE_VISITCOUNT VT_UI4 Liczba odwiedzonych przez użytkownika
PID_INTSITE_DESCRIPTION VT_LPWSTR Tekst opisu witryny
PID_INTSITE_COMMENT VT_LPWSTR Komentarz z adnotacjami użytkownika
PID_INTSITE_FLAGS VT_UI4 Wskazuje użycie flag PIDISF_ (patrz poniżej)
PID_INTSITE_CONTENTLEN N/A Obecnie nieobsługiwane
PID_INTSITE_CONTENTCODE N/A Obecnie nieobsługiwane
PID_INTSITE_RECURSE N/A Obecnie nieobsługiwane
PID_INTSITE_WATCH N/A Obecnie nieobsługiwane
PID_INTSITE_SUBSCRIPTION VT_UI8 WARTOŚĆ SUBSCRIPTIONCOOKIE dla menedżera subskrypcji
PID_INTSITE_URL VT_LPWSTR Adres URL, do którego prowadzi skrót
PID_INTSITE_TITLE VT_LPWSTR Title
PID_INTSITE_CODEPAGE VT_UI4 Strona kodowa dokumentu
PID_INTSITE_TRACKING N/A Obecnie nieobsługiwane
PID_INTSITE_ICONINDEX VT_I4 Indeks ikony
PID_INTSITE_ICONFILE VT_LPWSTR Plik zawierający ikonę
PID_INTSITE_ROAMED VT_UI4 Wpis został dodany z powodu roamingu

 

Poniżej znajdują się flagi witryny internetowej.

Flag Description
PIDISF_RECENTLYCHANGED Wskazuje, że witryna została niedawno zmieniona
PIDISF_CACHEDSTICKY Obecnie nieobsługiwane
PIDISF_CACHEIMAGES Obecnie nieobsługiwane
PIDISF_FOLLOWALLLINKS Obecnie nieobsługiwane

 

Następujące wartości są używane na potrzeby historii roamingu internetowego.

Wartość PID_INTSITE_ROAMED Description
Wartość nie jest ustawiona lub PIDISR_UP_TO_DATE Ten wpis pamięci podręcznej nie został zmodyfikowany przez roaming.
PIDISR_NEEDS_ADD Ten wpis pamięci podręcznej został dodany do pamięci podręcznej przez roaming. Ustaw PIDISR_UP_TO_DATE po zakończeniu przetwarzania wpisu.
PIDISR_NEEDS_UPDATE Ten wpis pamięci podręcznej już istniał na komputerze lokalnym, ale został zaktualizowany przez roaming. Ustaw PIDISR_UP_TO_DATE po zakończeniu przetwarzania wpisu.
PIDISR_NEEDS_DELETE Roaming wykrył, że ten wpis pamięci podręcznej powinien zostać usunięty. Na przykład użytkownik mógł wyczyścić jego historię przeglądarki. Usuń wpis przy użyciu metody DeleteUrlCacheEntry.

 

Interfaces

Obiekt skrótów internetowych uwidacznia wiele interfejsów.

OLE interfaces

Shell interfaces

Functions

Istnieje kilka funkcji narzędziowych, których można używać z obiektem skrótów internetowych.

Funkcje narzędzi skrótów internetowych

 

 

  • Last updated on