Função SetClassWord (winuser.h)

Artigo
08/28/2023

Substitui o valor de 16 bits (WORD) no deslocamento especificado na memória de classe extra para a classe de janela à qual a janela especificada pertence.

Nota Essa função é fornecida apenas para compatibilidade com versões de 16 bits do Windows. Os aplicativos devem usar a função SetClassLong .

Sintaxe

WORD SetClassWord(
  [in] HWND hWnd,
  [in] int  nIndex,
  [in] WORD wNewWord
);

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 de bytes baseado em zero do valor a ser substituído. Os valores válidos estão no intervalo zero até o número de bytes de memória da classe menos dois; por exemplo, se você especificasse 10 ou mais bytes de memória de classe extra, um valor de 8 seria um índice para o quinto inteiro de 16 bits.

[in] wNewWord

Tipo: WORD

O valor de substituição.

Valor retornado

Tipo: WORD

Se a função for bem-sucedida, o valor retornado será o valor anterior do inteiro de 16 bits especificado. Se o valor não tiver sido definido anteriormente, o valor retornado será zero.

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

Comentários

Reserve memória de classe extra especificando um valor diferente de zero no membro cbClsExtra da estrutura WNDCLASS usada com a função RegisterClass .

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll