Функция AllowSetForegroundWindow

Функция AllowSetForegroundWindow включает заданный процесс, чтобы установить приоритетное окно, используя функцию SetForegroundWindow. Вызывающий процесс должен уже получить возможность установить приоритетное окно. Для получения дополнительной информации, см. Замечания ниже в этой теме.

Синтаксис

BOOL AllowSetForegroundWindow(
          DWORD dwProcessId

);

Параметры

dwProcessId

[in] Определяет идентификатор процесса, который должен быть включенным, чтобы установить приоритетное окно. Если этот параметр является ASFW_ANY, все процессы, должен быть включенными, чтобы установить приоритетное окно.

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

Если функция завершается успешно, величина возвращаемого значения - не ноль.

Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Функция завершится ошибкой, если вызывающий процесс не может установить приоритетное окно. Чтобы получать дополнительные данные об ошибках, вызовите функцию GetLastError.

Замечания

Начинаясь с Microsoft ® Windows ® 98 и Windows 2000, система ограничивает, число процессов, которые могут устанавливать приоритетное окно. Процесс может установить приоритетное окно, только в том случае, если соблюдается одно из ниже перечисленных условий:

Процесс, который может устанавливать приоритетное окно, может дать возможность другому процессу установить приоритетное окно, вызывая AllowSetForegroundWindow. Процесс, заданный параметром dwProcessId теряет способность установить приоритетное окно в следующий раз, когда пользователь производит ввод данных, если ввод данных не направлен на этот процесс, или в следующий раз, кода процесс вызывает функцию AllowSetForegroundWindow, если тот процесс не определен.

Эта функция не реализуется. Поэтому, процессы должны сотрудничать, чтобы управлять приоритетным окном. Например, приложение может захотеть поддержать только один экземпляр программы. Когда запускается второй экземпляр, оно должно обнаружить предыдущий экземпляр и вызывать функцию SetForegroundWindow для окна предыдущего экземпляра. Оно не должно посылать сообщение к окну предыдущего экземпляра, запросившего приложение вызвать для себя функцию SetForegroundWindow, потому что предыдущий экземпляр не обязательно будет иметь разрешение вызвать SetForegroundWindow.

Смотри также

Краткий обзор Окна, LockSetForegroundWindow, SetForegroundWindow

 

Размещение и совместимость AllowSetForegroundWindow

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Да

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz