Интерфейс IShellLibrary (shobjidl_core.h)
Предоставляет методы для создания библиотек и управления ими.
Наследование
Интерфейс IShellLibrary наследуется от интерфейса IUnknown . IShellLibrary также имеет следующие типы членов:
Методы
Интерфейс IShellLibrary содержит следующие методы.
|
IShellLibrary::AddFolder Добавляет папку в библиотеку. |
|
IShellLibrary::Commit Фиксирует обновления библиотеки в существующем файле описания библиотеки. |
|
IShellLibrary::GetDefaultSaveFolder Извлекает целевую папку по умолчанию, которую библиотека использует для операций сохранения. |
|
IShellLibrary::GetFolders Возвращает набор дочерних папок, содержащихся в библиотеке. |
|
IShellLibrary::GetFolderType Возвращает тип папки библиотеки. |
|
IShellLibrary::GetIcon Возвращает значок по умолчанию для библиотеки. |
|
IShellLibrary::GetOptions Возвращает параметры библиотеки. |
|
IShellLibrary::LoadLibraryFromItem Загружает библиотеку из указанного файла определения библиотеки. |
|
IShellLibrary::LoadLibraryFromKnownFolder Загружает библиотеку, на которую ссылается ИЗВЕСТНЫЙFOLDERID. |
|
IShellLibrary::RemoveFolder Удаляет папку из библиотеки. |
|
IShellLibrary::ResolveFolder Разрешает целевое расположение папки библиотеки, даже если папка была перемещена или переименована. |
|
IShellLibrary::Save Сохраняет библиотеку в новый файл описания библиотеки (*.library-ms). |
|
IShellLibrary::SaveInKnownFolder Сохраняет библиотеку в новый файл в указанной известной папке. |
|
IShellLibrary::SetDefaultSaveFolder Задает целевую папку по умолчанию, которую библиотека будет использовать для операций сохранения. |
|
IShellLibrary::SetFolderType Задает тип папки библиотеки. |
|
IShellLibrary::SetIcon Задает значок по умолчанию для библиотеки. |
|
IShellLibrary::SetOptions Задает параметры библиотеки. |
Комментарии
Когда следует реализовать
Пользовательские реализации IShellLibrary не поддерживаются; клиентские приложения используют реализацию, предоставляемую Shell32.dll.Когда следует использовать
Используйте IShellLibrary для создания новой библиотеки, запроса или обновления атрибутов существующей библиотеки.Вспомогательные функции библиотеки
Shobjidl.h предоставляет следующие вспомогательные функции библиотеки.| Имя | Сводка |
|---|---|
| SHAddFolderPathToLibrary | Добавляет папку в библиотеку. |
| SHCreateLibrary | Создает объект IShellLibrary . |
| SHLoadLibraryFromItem | Создает и загружает объект IShellLibrary из указанного файла определения библиотеки. |
| SHLoadLibraryFromKnownFolder | Создает и загружает объект IShellLibrary для указанного ЗНАЧЕНИЯ KNOWNFOLDERID. |
| SHLoadLibraryFromParsingName | Создает и загружает объект IShellLibrary для указанного пути. |
| SHRemoveFolderPathFromLibrary | Удаляет папку из библиотеки. |
| SHResolveFolderPathInLibrary | Пытается разрешить целевое расположение папки библиотеки, которая была перемещена или переименована. |
| SHResolveLibrary | Пытается найти расположение библиотеки. |
| SHSaveLibraryInFolderPath | Сохраняет объект IShellLibrary на диск. |
| SHShowManageLibraryUI | Отображает диалоговое окно управления библиотекой, которое позволяет пользователям управлять папками библиотеки и расположением сохранения по умолчанию. |
Перечисления библиотек
Следующие перечисления поддерживают библиотеки.| Имя | Сводка |
|---|---|
| DEFAULTSAVEFOLDERTYPE | Указывает, является ли место сохранения по умолчанию общедоступным или частным. |
| LIBRARYOPTIONFLAGS | Задает параметры библиотеки. |
| LIBRARYSAVEFLAGS | Определяет параметры для обработки конфликта имен при сохранении библиотеки. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl_core.h (включая Shobjidl.h) |