Сочетания клавиш в Интернете
Объект ярлыка в Интернете используется для создания ярлыков на рабочем столе на сайтах Интернета. Как и сочетания клавиш для элементов в файловой системе, сочетания клавиш Интернета принимают форму значка на рабочем столе. Когда пользователь щелкает значок, браузер запускается и отображает сайт, связанный с ярлыком.
Рассматриваются следующие разделы.
- создание ярлыков в Интернете
- доступ к хранилищу свойств
- Интерфейсы
- интерфейсы OLE
- интерфейсы оболочки
- Функции
Создание ярлыков в Интернете
Вы можете создать ярлык в Интернете с помощью элемента управления WebBrowser или URL-адреса страницы.
Создание ярлыка в Интернете из элемента управления WebBrowser
Если приложение размещает элемент управления WebBrowser, можно использовать объект ярлыка в Интернете для создания ярлыков следующим образом.
- Создайте экземпляр объекта ярлыка в Интернете с CoCreateInstanceс помощью идентификатора класса (CLSID) CLSID_InternetShortcut.
- Передайте указатель на интерфейс IUnknown webBrowser в объект ярлыка Интернета с IObjectWithSite::SetSite.
- Вызовите метод объекта internet ярлыка IPersistFile::Save, если вы хотите создать ярлык для страницы, просматриваемой элементом управления WebBrowser.
Ярлык будет создан в расположении, указанном в IPersistFile::Save. Это расположение позволяет элементу управления WebBrowser восстановить состояние, которое включает задачу загрузки правильных документов в наборы кадров.
Создание ярлыка в Интернете из URL-адреса
Вы также можете создать ярлык в Интернете, если у вас есть URL-адрес страницы, на которую вы хотите связаться.
- Создайте экземпляр объекта ярлыка в Интернете с CoCreateInstanceс помощью CLSID CLSID_InternetShortcut.
- Используйте метод IUniformResourceLocator::SetURL, чтобы задать URL-адрес в ярлыке.
- Используйте метод IPersistFile::Save для сохранения ярлыка файла в нужном расположении.
Доступ к хранилищу свойств
Объект ярлыка в Интернете содержит несколько свойств, которые можно получить через интерфейса IPropertySetStorage с помощью следующей процедуры.
- Получите интерфейс IPropertySetStorage путем вызова QueryInterface с IID_IPropertySetStorage.
- Доступ к хранилищу свойств internet shortcut, вызвав IPropertySetStorage::Open с помощью FMTID_Intshcut или FMTID_InternetSite, чтобы получить интерфейс IPropertyStorage.
- Прочитайте сведения о хранилище свойств с помощью 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 | N/A | В настоящее время не поддерживается |
| PID_INTSITE_CONTENTCODE | N/A | В настоящее время не поддерживается |
| PID_INTSITE_RECURSE | N/A | В настоящее время не поддерживается |
| PID_INTSITE_WATCH | N/A | В настоящее время не поддерживается |
| 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 | N/A | В настоящее время не поддерживается |
| PID_INTSITE_ICONINDEX | VT_I4 | Индекс значка |
| PID_INTSITE_ICONFILE | VT_LPWSTR | Файл, содержащий значок |
| PID_INTSITE_ROAMED | VT_UI4 | Запись была добавлена из-за роуминга |
Ниже приведены флаги сайта Интернета.
| Флаг | Описание |
|---|---|
| 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
Интерфейсы оболочки
Функции
Существует несколько служебных функций, которые можно использовать с объектом ярлыка в Интернете.
Функции служебной программы сочетания клавиш в Интернете