Bagikan melalui

Pintasan Internet

  • Artikel

Objek pintasan Internet digunakan untuk membuat pintasan desktop ke situs Internet. Seperti pintasan ke item dalam sistem file, pintasan Internet mengambil bentuk ikon pada desktop. Ketika pengguna mengklik ikon, browser diluncurkan dan menampilkan situs yang terkait dengan pintasan.

Topik berikut dibahas.

Membuat Pintasan Internet

Anda dapat membuat pintasan Internet dengan menggunakan kontrol WebBrowser atau dengan URL halaman.

Membuat Pintasan Internet dari Kontrol WebBrowser

Jika aplikasi Anda menghosting kontrol WebBrowser, Anda dapat menggunakan objek pintasan Internet untuk membuat pintasan dengan cara berikut.

  1. Buat instans objek pintasan Internet dengan CoCreateInstance, menggunakan pengidentifikasi kelas (CLSID) CLSID_InternetShortcut.
  2. Teruskan penunjuk ke antarmuka IUnknown WebBrowser ke objek pintasan Internet dengan IObjectWithSite::SetSite.
  3. Panggil metode IPersistFile::Simpan objek pintasan Internet saat Anda ingin membuat pintasan ke halaman yang sedang dilihat oleh kontrol WebBrowser.

Pintasan akan dibuat di lokasi yang ditentukan di IPersistFile::Simpan. Lokasi ini memungkinkan kontrol WebBrowser untuk memulihkan statusnya, yang mencakup tugas pemuatan dokumen yang benar ke dalam frameset.

Membuat Pintasan Internet dari URL

Anda juga dapat membuat pintasan Internet jika Anda memiliki URL halaman yang ingin Anda tautkan.

  1. Buat instans objek pintasan Internet dengan CoCreateInstance, menggunakan CLSID CLSID_InternetShortcut.
  2. Gunakan metode IUniformResourceLocator::SetURL untuk mengatur URL di pintasan.
  3. Gunakan metode IPersistFile::Simpan untuk menyimpan file pintasan ke lokasi yang diinginkan.

Mengakses Penyimpanan Properti

Objek pintasan Internet berisi beberapa properti yang dapat Anda akses melalui antarmuka IPropertySetStorage objek dengan prosedur berikut.

  1. Dapatkan antarmuka IPropertySetStorage dengan memanggil QueryInterface dengan IID_IPropertySetStorage.
  2. Akses set penyimpanan properti pintasan Internet dengan memanggil IPropertySetStorage::Buka dengan FMTID_Intshcut atau FMTID_InternetSite untuk mendapatkan antarmuka IPropertyStorage.
  3. Baca informasi penyimpanan properti dengan IPropertyStorage::ReadMultiple dengan meneruskan ID properti yang sesuai.

Dengan versi 4.70 atau lebih tinggi Shell32.dll, Anda juga dapat mengambil antarmuka IPropertySetStorage dengan memanggil IShellFolder::BindToStorage dengan parameter pidl diatur ke . File URL dan parameter riid diatur ke IID_IPropertySetStorage.

ID properti berikut dapat diminta untuk FMTID_Intshcut.

PROPID Jenis Varian Deskripsi
PID_IS_URL VT_LPWSTR URL yang ditunjukkan pintasan
PID_IS_NAME VT_LPWSTR Nama pintasan Internet
PID_IS_WORKINGDIR VT_LPWSTR Direktori kerja untuk pintasan
PID_IS_HOTKEY VT_UI2 Hotkey untuk pintasan
PID_IS_SHOWCMD VT_I4 Perlihatkan perintah untuk pintasan
PID_IS_ICONINDEX VT_I4 Indeks ikon
PID_IS_ICONFILE VT_LPWSTR File yang berisi ikon
PID_IS_WHATSNEW VT_LPWSTR Apa itu Teks baru
PID_IS_AUTHOR VT_LPWSTR Pengarang
PID_IS_DESCRIPTION VT_LPWSTR Teks deskripsi situs
PID_IS_COMMENT VT_LPWSTR Komentar anotasi pengguna
PID_IS_ROAMED VT_BOOL True ketika pintasan di jelajah untuk pertama kalinya

 

ID properti berikut dapat diminta untuk FMTID_InternetSite.

PROPID Jenis Varian Deskripsi
PID_INTSITE_WHATSNEW VT_LPWSTR Apa itu Teks baru
PID_INTSITE_AUTHOR VT_LPWSTR Pengarang
PID_INTSITE_LASTVISIT VT_FILETIME Situs waktu terakhir dikunjungi
PID_INTSITE_LASTMOD VT_FILETIME Situs waktu terakhir diubah
PID_INTSITE_VISITCOUNT VT_UI4 Berapa kali pengguna telah mengunjungi
PID_INTSITE_DESCRIPTION VT_LPWSTR Teks deskripsi situs
PID_INTSITE_COMMENT VT_LPWSTR Komentar anotasi pengguna
PID_INTSITE_FLAGS VT_UI4 Menunjukkan penggunaan bendera PIDISF_ (lihat di bawah)
PID_INTSITE_CONTENTLEN N/A Saat ini tidak didukung
PID_INTSITE_CONTENTCODE N/A Saat ini tidak didukung
PID_INTSITE_RECURSE N/A Saat ini tidak didukung
PID_INTSITE_WATCH N/A Saat ini tidak didukung
PID_INTSITE_SUBSCRIPTION VT_UI8 Nilai SUBSCRIPTIONCOOKIE untuk manajer langganan
PID_INTSITE_URL VT_LPWSTR URL yang ditunjukkan pintasan
PID_INTSITE_TITLE VT_LPWSTR Titel
PID_INTSITE_CODEPAGE VT_UI4 Halaman kode dokumen
PID_INTSITE_TRACKING N/A Saat ini tidak didukung
PID_INTSITE_ICONINDEX VT_I4 Indeks ikon
PID_INTSITE_ICONFILE VT_LPWSTR File yang berisi ikon
PID_INTSITE_ROAMED VT_UI4 Entri ditambahkan karena roaming

 

Berikut ini adalah bendera situs Internet.

Bendera Deskripsi
PIDISF_RECENTLYCHANGED Menunjukkan bahwa situs baru-baru ini diubah
PIDISF_CACHEDSTICKY Saat ini tidak didukung
PIDISF_CACHEIMAGES Saat ini tidak didukung
PIDISF_FOLLOWALLLINKS Saat ini tidak didukung

 

Nilai berikut digunakan untuk riwayat roaming Internet.

Nilai PID_INTSITE_ROAMED Deskripsi
Nilai tidak diatur atau PIDISR_UP_TO_DATE Entri cache ini belum dimodifikasi oleh roaming.
PIDISR_NEEDS_ADD Entri cache ini ditambahkan ke cache dengan roaming. Atur PIDISR_UP_TO_DATE setelah pemrosesan entri selesai.
PIDISR_NEEDS_UPDATE Entri cache ini sudah ada pada komputer lokal, tetapi diperbarui dengan roaming. Atur PIDISR_UP_TO_DATE setelah pemrosesan entri selesai.
PIDISR_NEEDS_DELETE Roaming mendeteksi bahwa entri cache ini harus dihapus. Misalnya, pengguna mungkin telah menghapus riwayat browsernya. Hapus entri menggunakan DeleteUrlCacheEntry.

 

Antarmuka

Objek pintasan Internet mengekspos sejumlah antarmuka.

Antarmuka OLE

Antarmuka shell

Fungsi

Ada beberapa fungsi utilitas yang dapat digunakan dengan objek pintasan Internet.

Fungsi utilitas pintasan internet