Функция SetParent (winuser.h)

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

Синтаксис

HWND SetParent(
  [in]           HWND hWndChild,
  [in, optional] HWND hWndNewParent
);

Параметры

[in] hWndChild

Тип: HWND

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

[in, optional] hWndNewParent

Тип: HWND

Дескриптор нового родительского окна. Если этот параметр имеет значение NULL, окно рабочего стола становится новым родительским окном. Если этот параметр HWND_MESSAGE, дочернее окно становится окном только для сообщений.

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

Тип: HWND

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

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

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

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

Из соображений совместимости SetParent не изменяет WS_CHILD или WS_POPUP стилей окна, родитель которого изменяется. Поэтому, если hWndNewParent имеет значение NULL, необходимо также очистить бит WS_CHILD и задать стиль WS_POPUP после вызова SetParent. И наоборот, если hWndNewParent не имеет значение NULL и окно ранее было дочерним элементом рабочего стола, необходимо очистить стиль WS_POPUP и задать стиль WS_CHILD перед вызовом SetParent.

При изменении родительского элемента окна необходимо синхронизировать UISTATE обоих окон. Дополнительные сведения см. в разделе WM_CHANGEUISTATE и WM_UPDATEUISTATE.

Если hWndNewParent и hWndChild Работают в разных режимах отслеживания DPI, могут возникнуть непредвиденные ошибки. В следующей таблице описано это поведение:

Дополнительные сведения об уровне DPI см. в документации windows High DPI.

Требования

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

Основные понятия

GetParent

Справочные материалы

Windows