Функция
AllowSetForegroundWindowФункция
AllowSetForegroundWindow включает заданный процесс, чтобы установить приоритетное окно, используя функцию SetForegroundWindow. Вызывающий процесс должен уже получить возможность установить приоритетное окно. Для получения дополнительной информации, см. Замечания ниже в этой теме.Синтаксис
BOOLAllowSetForegroundWindow( 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 |
Нет |
Замечания по платформе |
Не имеется |