Função SetWindowLongW (winuser.h)

Altera um atributo da janela especificada. A função também define o valor de 32 bits (longo) no deslocamento especificado para a memória extra da janela.

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela e, indiretamente, a classe à qual a janela pertence.

[in] nIndex

Tipo: int

O deslocamento baseado em zero para o valor a ser definido. Os valores válidos estão no intervalo zero até o número de bytes de memória de janela extra, menos o tamanho de um inteiro. Para definir qualquer outro valor, especifique um dos valores a seguir.

Os valores a seguir também estão disponíveis quando o parâmetro hWnd identifica uma caixa de diálogo.

[in] dwNewLong

Tipo: LONG

O valor de substituição.

Valor retornado

Tipo: LONG

Se a função for bem-sucedida, o valor retornado será o valor anterior do inteiro de 32 bits especificado.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Se o valor anterior do inteiro de 32 bits especificado for zero e a função for bem-sucedida, o valor retornado será zero, mas a função não limpará as últimas informações de erro. Isso dificulta a determinação de êxito ou falha. Para lidar com isso, você deve limpar as últimas informações de erro chamando SetLastError com 0 antes de chamar SetWindowLong. Em seguida, a falha de função será indicada por um valor retornado de zero e um resultado GetLastError diferente de zero.

Comentários

Determinados dados de janela são armazenados em cache, portanto, as alterações feitas usando SetWindowLong não entrarão em vigor até que você chame a função SetWindowPos . Especificamente, se você alterar qualquer um dos estilos de quadro, deverá chamar SetWindowPos com o sinalizador SWP_FRAMECHANGED para que o cache seja atualizado corretamente.

Se você usar SetWindowLong com o índice GWL_WNDPROC para substituir o procedimento de janela, o procedimento de janela deverá estar em conformidade com as diretrizes especificadas na descrição da função de retorno de chamada WindowProc .

Se você usar SetWindowLong com o índice DWL_MSGRESULT para definir o valor retornado de uma mensagem processada por um procedimento de caixa de diálogo, retornará TRUE diretamente depois. Caso contrário, se você chamar qualquer função que resulte no procedimento de caixa de diálogo recebendo uma mensagem de janela, a mensagem de janela aninhada poderá substituir o valor retornado definido usando DWL_MSGRESULT.

Chamar SetWindowLong com o índice GWL_WNDPROC cria uma subclasse da classe de janela usada para criar a janela. Um aplicativo pode subclasse uma classe do sistema, mas não deve subclasse uma classe de janela criada por outro processo. A função SetWindowLong cria a subclasse de janela alterando o procedimento de janela associado a uma classe de janela específica, fazendo com que o sistema chame o novo procedimento de janela em vez do anterior. Um aplicativo deve passar todas as mensagens não processadas pelo novo procedimento de janela para o procedimento de janela anterior chamando CallWindowProc. Isso permite que o aplicativo crie uma cadeia de procedimentos de janela.

Reserve memória de janela extra especificando um valor diferente de zero no membro cbWndExtra da estrutura WNDCLASSEX usada com a função RegisterClassEx .

Você não deve chamar SetWindowLong com o índice GWL_HWNDPARENT para alterar o pai de uma janela filho. Em vez disso, use a função SetParent .

Se a janela tiver um estilo de classe de CS_CLASSDC ou CS_OWNDC, não defina os estilos de janela estendidos WS_EX_COMPOSITED ou WS_EX_LAYERED.

Chamar SetWindowLong para definir o estilo em uma barra de progresso redefinirá sua posição.

Exemplos

Para obter um exemplo, consulte Subclasse de uma janela.

Requisitos

Confira também

CallWindowProc

Conceitual

Getwindowlong

Referência

Registerclassex

Setparent

SetWindowLongPtr

WNDCLASSEX

Classes de janela

WindowProc