Acerca de las propiedades de la ventana

Una propiedad window es cualquier dato asignado a una ventana. Una propiedad de ventana suele ser un identificador de los datos específicos de la ventana, pero puede ser cualquier valor. Cada propiedad de ventana se identifica mediante un nombre de cadena. Hay varias funciones que permiten a las aplicaciones usar propiedades de ventana. En esta introducción se describen los temas siguientes:

• Ventajas del uso de propiedades de ventana
• Asignar propiedades de ventana
• Enumerar las propiedades de la ventana

Ventajas del uso de propiedades de ventana

Normalmente, las propiedades de ventana se usan para asociar datos a una ventana subclase o una ventana en una aplicación de interfaz de varios documentos (MDI). En cualquier caso, no es conveniente usar los bytes adicionales especificados en la función CreateWindow o la estructura de clases por los dos motivos siguientes:

• Es posible que una aplicación no sepa cuántos bytes adicionales están disponibles o cómo se usa el espacio. Mediante el uso de propiedades de ventana, la aplicación puede asociar datos a una ventana sin tener acceso a los bytes adicionales.
• Una aplicación debe tener acceso a los bytes adicionales mediante desplazamientos. Sin embargo, sus identificadores de cadena tienen acceso a las propiedades de ventana, no por desplazamientos.

Para obtener más información sobre las subclases, vea Subclases de procedimiento de ventana. Para obtener más información sobre las ventanas MDI, vea Multiple Document Interface.

Asignar propiedades de ventana

La función SetProp asigna una propiedad de ventana y su identificador de cadena a una ventana. La función GetProp recupera la propiedad window identificada por la cadena especificada. La función RemoveProp destruye la asociación entre una ventana y una propiedad window, pero no destruye los datos en sí. Para destruir los propios datos, use la función adecuada para liberar el identificador devuelto por RemoveProp.

Enumerar las propiedades de la ventana

Las funciones EnumProps y EnumPropsEx enumeran todas las propiedades de una ventana mediante una función de devolución de llamada definida por la aplicación. Para obtener más información sobre la función de devolución de llamada, vea PropEnumProc.

EnumPropsEx incluye un parámetro adicional para los datos definidos por la aplicación usados por la función de devolución de llamada. Para obtener más información sobre la función de devolución de llamada, vea PropEnumProcEx.