Метод IShellView2::GetView (shobjidl_core.h)

Статья
08/26/2023

Запрашивает текущее представление оболочки или представление по умолчанию вместе со всеми другими допустимыми идентификаторами представлений (VID), поддерживаемыми этой реализацией IShellView2.

Синтаксис

HRESULT GetView(
  [out] SHELLVIEWID *pvid,
  [in]  ULONG       uView
);

Параметры

[out] pvid

Тип: SHELLVIEWID*

Указатель на GUID запрошенного представления. Следующие представления определены в Shlguid.h.

VID_LargeIcons

{0057D0E0-3573-11CF-AE69-08002B2E1262}

VID_SmallIcons

{089000C0-3573-11CF-AE69-08002B2E1262}

VID_List

{0E1FA5E0-3573-11CF-AE69-08002B2E1262}

VID_Details

{137E7700-3573-11CF-AE69-08002B2E1262}

VID_Tile

{65F125E5-7BE1-4810-BA9D-D271C8432CE3}

[in] uView

Тип: ULONG

Тип запрошенного представления.

SV2GV_CURRENTVIEW

Текущее представление оболочки.

SV2GV_DEFAULTVIEW

Представление оболочки по умолчанию.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения, или стандартный код ошибки COM в противном случае.

IShellView2::GetView извлекает "набор представлений", который является запрошенным представлением (по умолчанию или текущим) вместе со всеми остальными допустимыми представлениями для этого экземпляра IShellView2. Вызов IShellView2::GetView с SV2GV_CURRENTVIEW возвращает GUID, представляющий текущее представление, а также выполняет итерацию по допустимым идентификаторам VID. Эти сведения хранятся для последующего использования при проверке нового представления перед его отображением.

На представление также могут влиять другие факторы. Глобальный пользователь по умолчанию VID и режим просмотра устанавливается, когда пользователь нажимает кнопку Применить ко всем папкам в окне Параметры папки . VID определяется из IShellView2::GetView с флагом SV2GV_CURRENTVIEW , а режим просмотра определяется из GetCurrentInfo. На представление также может повлиять сохраненная папка по умолчанию. Windows Обозреватель сохраняет режим VID и просмотра папки, если пользователь ранее посещал ее. В некоторых случаях папка, из которую вы перейдете, также может повлиять на режим представления, созданный для нового представления, которое вы вводите.

Как правило, приоритетом этих различных представлений может быть следующее:

Сохраненная папка по умолчанию
Глобальный пользователь по умолчанию
Представление по умолчанию (SV2GV_DEFAULTVIEW)
Предыдущее представление

Приоритет предыдущего представления может быть выше, если в разделе Параметры папки не выбран параметр Запомнить параметры представления каждой папки. Другие факторы, такие как политика, также могут вступить в игру, поэтому приведенный выше список следует рассматривать только как очень широкий ориентир.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll (версия 4.71 или более поздняя)

Поделиться через