Función SetClassLongA (winuser.h)
Reemplaza el valor especificado de 32 bits (
Sintaxis
DWORD SetClassLongA(
[in] HWND hWnd,
[in] int nIndex,
[in] LONG dwNewLong
);
Parámetros
[in] hWnd
Tipo: HWND
Identificador de la ventana y, indirectamente, de la clase a la que pertenece la ventana.
[in] nIndex
Tipo: int
Valor que se va a reemplazar. Para establecer un valor de 32 bits en la memoria de clase adicional, especifique el desplazamiento de bytes positivo basado en cero del valor que se va a establecer. Los valores válidos están en el intervalo cero a través del número de bytes de memoria de clase adicional, menos cuatro; Por ejemplo, si especificó 12 o más bytes de memoria de clase adicional, un valor de 8 sería un índice para el tercer entero de 32 bits. Para establecer cualquier otro valor de la estructura de WNDCLASSEX, especifique uno de los valores siguientes.
Valor | Significado |
---|---|
|
Establece el tamaño, en bytes, de la memoria adicional asociada a la clase . Establecer este valor no cambia el número de bytes adicionales ya asignados. |
|
Establece el tamaño, en bytes, de la memoria de ventana adicional asociada a cada ventana de la clase . Establecer este valor no cambia el número de bytes adicionales ya asignados. Para obtener información sobre cómo acceder a esta memoria, vea SetWindowLong. |
|
Reemplaza un identificador al pincel de fondo asociado a la clase . |
|
Reemplaza un identificador al cursor asociado a la clase . |
|
Reemplaza un identificador al icono asociado a la clase . |
|
Reemplace un identificador al icono pequeño asociado a la clase . |
|
Reemplaza un identificador al módulo que registró la clase . |
|
Reemplaza la dirección de la cadena de nombre del menú. La cadena identifica el recurso de menú asociado a la clase . |
|
Reemplaza los bits de estilo de clase de ventana. |
|
Reemplaza la dirección del procedimiento de ventana asociado a la clase . |
[in] dwNewLong
Tipo: LONG
Valor de reemplazo.
Valor devuelto
Tipo: DWORD de
Si la función se ejecuta correctamente, el valor devuelto es el valor anterior del entero de 32 bits especificado. Si el valor no se estableció anteriormente, el valor devuelto es cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Si usa la función
Al llamar a SetClassLong con el índice de GCL_WNDPROC, se crea una subclase de la clase window que afecta a todas las ventanas creadas posteriormente con la clase . Una aplicación puede subclase una clase del sistema, pero no debe subclase una clase de ventana creada por otro proceso.
Reserva memoria de clase adicional especificando un valor distinto de cero en el miembro
Use la función
Ejemplos
Para obtener un ejemplo, vea Mostrar un icono.
Nota
El encabezado winuser.h define SetClassLong como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
de la plataforma de destino de |
Windows |
encabezado de |
winuser.h (incluya Windows.h) |
biblioteca de |
User32.lib |
DLL de |
User32.dll |
conjunto de API de |
ext-ms-win-ntuser-windowclass-l1-1-2 (introducido en Windows 10, versión 10.0.10240) |
Consulte también
conceptual de
GetClassLong de
de referencia de
clases de ventana de