Метод ICommDlgBrowser::OnStateChange (shobjidl_core.h)

Статья
08/26/2023

Вызывается после изменения состояния, определяемого параметром uChange , в интерфейсе IShellView .

Синтаксис

HRESULT OnStateChange(
  IShellView *ppshv,
  ULONG      uChange
);

Параметры

ppshv

Тип: IShellView*

Указатель на интерфейс IShellView представления.

uChange

Тип: ULONG

Изменение состояния выделения. Этот параметр может принимать одно из указанных ниже значений.

CDBOSC_SETFOCUS

Фокус установлен на представление.

CDBOSC_KILLFOCUS

Представление потеряло фокус.

CDBOSC_SELCHANGE

Выбор изменился.

CDBOSC_RENAME

Элемент переименован.

CDBOSC_STATECHANGE

Элемент установлен или снят.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

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

Примечание к вызывающим приложениям

Если элементы в представлении выбраны или представление теряет фокус, необходимо вызвать этот метод, чтобы уведомить общее диалоговое окно об изменении состояния представления или выделения.

Требования

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

См. также раздел

ICommDlgBrowser

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