Сочетания клавиш в Интернете
Объект ярлыка Интернета используется для создания ярлыков на рабочем столе для веб-сайтов. Как и ярлыки для элементов в файловой системе, ярлыки в Интернете принимают форму значка на рабочем столе. Когда пользователь щелкает значок, браузер запускается и отображает сайт, связанный с ярлыком.
Рассматриваются следующие темы.
Создание ярлыков в Интернете
Ярлык в Интернете можно создать с помощью элемента управления WebBrowser или с URL-адресом страницы.
Создание ярлыка в Интернете из элемента управления WebBrowser
Если в приложении размещается элемент управления WebBrowser, можно использовать объект ярлыка в Интернете для создания ярлыков следующим образом.
- Создайте экземпляр объекта ярлыка Интернета с coCreateInstance, используя идентификатор класса (CLSID) CLSID_InternetShortcut.
- Передайте указатель на интерфейс IUnknown WebBrowser в объект ярлыка Интернета с помощью IObjectWithSite::SetSite.
- Вызовите метод IPersistFile::Save объекта ярлыка Интернета, если требуется создать ярлык на страницу, просматриваемую элементом управления WebBrowser.
Ярлык будет создан в расположении, указанном в IPersistFile::Save. Это расположение позволяет элементу управления WebBrowser восстановить свое состояние, включая задачу загрузки правильных документов в наборы фреймов.
Создание ярлыка в Интернете на основе URL-адреса
Вы также можете создать ярлык в Интернете, если у вас есть URL-адрес страницы, на которую вы хотите создать ссылку.
- Создайте экземпляр объекта ярлыка Интернета с coCreateInstance, используя CLSID CLSID_InternetShortcut.
- Используйте метод IUniformResourceLocator::SetURL , чтобы задать URL-адрес в ярлыке.
- Используйте метод IPersistFile::Save , чтобы сохранить файл ярлыка в нужном расположении.
Доступ к хранилищу свойств
Объект ярлыка Интернета содержит несколько свойств, доступ к которым можно получить через интерфейс IPropertySetStorage объекта с помощью следующей процедуры.
- Получите интерфейс IPropertySetStorage , вызвав QueryInterface с IID_IPropertySetStorage.
- Чтобы получить интерфейс IPropertyStorage, получите доступ к набору хранилища свойств ярлыков в Интернете, вызвав метод IPropertySetStorage::Open с FMTID_Intshcut или FMTID_InternetSite.
- Чтение сведений о хранилище свойств с помощью IPropertyStorage::ReadMultiple путем передачи соответствующего идентификатора свойства.
В версии 4.70 или более поздней версии Shell32.dll можно также получить интерфейс IPropertySetStorage , вызвав IShellFolder::BindToStorage с параметром pidl , для которого задано значение . URL-файл и параметр riid , для IID_IPropertySetStorage.
Для FMTID_Intshcut можно запросить следующие идентификаторы свойств.
| PROPID | Тип variant | Описание |
|---|---|---|
| PID_IS_URL | VT_LPWSTR | URL-адрес, к которому ведет ярлык |
| PID_IS_NAME | VT_LPWSTR | Имя ярлыка в Интернете |
| PID_IS_WORKINGDIR | VT_LPWSTR | Рабочий каталог для ярлыка |
| PID_IS_HOTKEY | VT_UI2 | Горячая клавиша для ярлыка |
| PID_IS_SHOWCMD | VT_I4 | Показать команду для ярлыка |
| PID_IS_ICONINDEX | VT_I4 | Индекс значка |
| PID_IS_ICONFILE | VT_LPWSTR | Файл, содержащий значок |
| PID_IS_WHATSNEW | VT_LPWSTR | Новые возможности текста |
| PID_IS_AUTHOR | VT_LPWSTR | Автор |
| PID_IS_DESCRIPTION | VT_LPWSTR | Текст описания сайта |
| PID_IS_COMMENT | VT_LPWSTR | Комментарий пользователя с заметками |
| PID_IS_ROAMED | VT_BOOL. | True, если ярлык перемещается в первый раз |
Для FMTID_InternetSite можно запросить следующие идентификаторы свойств.
| PROPID | Тип variant | Описание |
|---|---|---|
| PID_INTSITE_WHATSNEW | VT_LPWSTR | Новые возможности текста |
| PID_INTSITE_AUTHOR | VT_LPWSTR | Автор |
| PID_INTSITE_LASTVISIT | VT_FILETIME | Время последнего посещения сайта |
| PID_INTSITE_LASTMOD | VT_FILETIME | Время последнего изменения сайта |
| PID_INTSITE_VISITCOUNT | VT_UI4 | Количество посещений пользователем |
| PID_INTSITE_DESCRIPTION | VT_LPWSTR | Текст описания сайта |
| PID_INTSITE_COMMENT | VT_LPWSTR | Комментарий пользователя с заметками |
| PID_INTSITE_FLAGS | VT_UI4 | Указывает на использование флагов PIDISF_ (см. ниже). |
| PID_INTSITE_CONTENTLEN | Н/Д | Сейчас не поддерживается |
| PID_INTSITE_CONTENTCODE | Н/Д | Сейчас не поддерживается |
| PID_INTSITE_RECURSE | Н/Д | Сейчас не поддерживается |
| PID_INTSITE_WATCH | Н/Д | Сейчас не поддерживается |
| PID_INTSITE_SUBSCRIPTION | VT_UI8 | ЗНАЧЕНИЕ SUBSCRIPTIONCOOKIE для диспетчера подписок |
| PID_INTSITE_URL | VT_LPWSTR | URL-адрес, к которому ведет ярлык |
| PID_INTSITE_TITLE | VT_LPWSTR | Заголовок |
| PID_INTSITE_CODEPAGE | VT_UI4 | Кодовая страница документа |
| PID_INTSITE_TRACKING | Н/Д | Сейчас не поддерживается |
| PID_INTSITE_ICONINDEX | VT_I4 | Индекс значка |
| PID_INTSITE_ICONFILE | VT_LPWSTR | Файл, содержащий значок |
| PID_INTSITE_ROAMED | VT_UI4 | Запись была добавлена из-за роуминга |
Ниже приведены флаги веб-сайтов.
| Flag | Описание |
|---|---|
| PIDISF_RECENTLYCHANGED | Указывает, что сайт был недавно изменен |
| PIDISF_CACHEDSTICKY | Сейчас не поддерживается |
| PIDISF_CACHEIMAGES | Сейчас не поддерживается |
| PIDISF_FOLLOWALLLINKS | Сейчас не поддерживается |
Следующие значения используются для журнала роуминга Через Интернет.
| Значение PID_INTSITE_ROAMED | Описание |
|---|---|
| Значение не задано или PIDISR_UP_TO_DATE | Эта запись кэша не была изменена в роуминге. |
| PIDISR_NEEDS_ADD | Эта запись кэша была добавлена в кэш в роуминге. Задайте PIDISR_UP_TO_DATE после завершения обработки записи. |
| PIDISR_NEEDS_UPDATE | Эта запись кэша уже существовала на локальном компьютере, но была обновлена в роуминге. Задайте PIDISR_UP_TO_DATE после завершения обработки записи. |
| PIDISR_NEEDS_DELETE | В роуминге обнаружено, что эта запись кэша должна быть удалена. Например, пользователь мог очистить журнал браузера. Удалите запись с помощью DeleteUrlCacheEntry. |
Интерфейсы
Объект ярлыка Интернета предоставляет ряд интерфейсов.
интерфейсы OLE
Интерфейсы оболочки
Функции
Существует несколько служебных функций, которые можно использовать с объектом ярлыка в Интернете.
Функции программы ярлыков в Интернете