Функция SetParent


Функция SetParent заменяет родительское окно заданного дочернего окна.

Синтаксис

HWND SetParent(

HWND hWndChild,    // дескриптор окна, родитель 
                   // которого изменяется

HWND
hWndNewParent // дескриптор нового родительского окна

);

Параметры

hWndChild

[in] Дескриптор дочернего окна.

hWndNewParent

[in] Дескриптор нового родительского окна. Если этот параметр - ПУСТО (NULL), окно рабочего стола становится новым родительским окном. Windows 2000 /XP: Если этот параметр - HWND_MESSAGE, дочернее окно становится окном только для сообщения.

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

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

Если функция не выполняет задачу, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительные данные об ошибках, вызовите GetLastError.

Замечания

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

Если окно, идентифицированное параметром hWndChild видимое, система выполняет соответствующую перерисовку и перекрашивание.

По причинам совместимости, функция SetParent не изменяет стили WS_CHILD или WS_POPUP окна, родитель которого изменяется. Поэтому, если параметр hWndNewParent имеет значение ПУСТО (NULL), Вы должны к тому же сбросить бит WS_CHILD и установить стиль WS_POPUP после вызова SetParent. И наоборот, если hWndNewParent не имеет значения ПУСТО (NULL) и окно было перед этим дочернее окно рабочего стола, Вы должны сбросить бит стиля WS_POPUP и установить стиль WS_CHILD перед вызовом SetParent.

Windows 2000 /XP: Когда Вы изменяете родителя окна, Вы должны синхронизировать UISTATE обоих окон. Для получения дополнительной информации, см. описание флажков WM_CHANGEUISTATE и WM_UPDATEUISTATE.

Смотри также

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

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

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