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

Изменяет атрибут указанного окна. Функция также задает 32-разрядное (длинное) значение по указанному смещение в дополнительном окне памяти.

Синтаксис

LONG SetWindowLongA(
  [in] HWND hWnd,
  [in] int  nIndex,
  [in] LONG dwNewLong
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна и, косвенно, класс, которому принадлежит окно.

[in] nIndex

Тип: int

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

Следующие значения также доступны, когда параметр hWnd определяет диалоговое окно.

[in] dwNewLong

Тип: LONG

Значение замены.

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

Тип: LONG

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

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

Если предыдущее значение указанного 32-разрядного целого числа равно нулю, а функция завершается успешно, возвращаемое значение равно нулю, но функция не очищает последние сведения об ошибке. Это затрудняет определение успеха или сбоя. Чтобы справиться с этим, необходимо очистить последнюю информацию об ошибке, вызвав SetLastError с 0 перед вызовом SetWindowLong. Затем ошибка функции будет указана возвращаемым значением нуля и результатом GetLastError , ненулевом.

Замечания

Некоторые данные окна кэшируются, поэтому изменения, внесенные с помощью SetWindowLong , не вступают в силу, пока не вызовете функцию SetWindowPos . В частности, если изменить любой из стилей кадров, необходимо вызвать SetWindowPos с флагом SWP_FRAMECHANGED для правильного обновления кэша.

При использовании SetWindowLong с индексом GWL_WNDPROC для замены процедуры окна процедура окна должна соответствовать рекомендациям, указанным в описании функции обратного вызова WindowProc .

Если вы используете SetWindowLong с индексом DWL_MSGRESULT для задания возвращаемого значения сообщения, обработанного процедурой диалога, необходимо вернуть значение TRUE непосредственно после этого. В противном случае при вызове любой функции, которая приводит к получению сообщения окна, сообщение вложенного окна может перезаписать возвращаемое значение, заданное с помощью DWL_MSGRESULT.

Вызов SetWindowLong с индексом GWL_WNDPROC создает подкласс класса окна, используемого для создания окна. Приложение может подкласс системного класса, но не должно подкласса класса окна, созданного другим процессом. Функция SetWindowLong создает подкласс окна, изменив процедуру окна, связанную с определенным классом окна, что приводит к тому, что система вызывает новую процедуру окна вместо предыдущей. Приложение должно передавать сообщения, не обработанные новой процедурой окна, в предыдущую процедуру окна путем вызова CallWindowProc. Это позволяет приложению создавать цепочку процедур окон.

Зарезервируйте дополнительную память окна, указав ненулевое значение в члене cbWndExtra структуры WNDCLASSEX , используемой с функцией RegisterClassEx .

Не вызывайте SetWindowLong с индексом GWL_HWNDPARENT , чтобы изменить родительский элемент дочернего окна. Вместо этого используйте функцию SetParent .

GWL_HWNDPARENT используется для изменения владельца окна верхнего уровня, а не родительского элемента дочернего окна.

Окно может иметь либо родителя, либо владельца, либо ни одного из них, но никогда не одновременно.

Если в окне есть стиль класса CS_CLASSDC или CS_OWNDC, не устанавливайте стили расширенных окон WS_EX_COMPOSITED или WS_EX_LAYERED.

Вызов SetWindowLong , чтобы задать стиль на панели выполнения, сбросит его положение.

Примеры

Пример см. в разделе "Подкласс окна".

Требования

См. также

CallWindowProc

Концептуальный

GetWindowLong

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

RegisterClassEx

SetParent

SetWindowLongPtr

WNDCLASSEX

классы окон

WindowProc