Sobre as propriedades da janela
Uma propriedade de janela é qualquer dado atribuído a uma janela. Uma propriedade de janela geralmente é um identificador dos dados específicos da janela, mas pode ser qualquer valor. Cada propriedade de janela é identificada por um nome de string. Há várias funções que permitem que os aplicativos usem propriedades de janela. Esta visão geral discute os seguintes tópicos:
- Vantagens de Usar Propriedades de Janela
- Atribuindo propriedades de janela
- Enumerando propriedades da janela
Vantagens de usar propriedades de janela
As propriedades da janela são normalmente usadas para associar dados a uma janela subclassificada ou a uma janela em um aplicativo de interface de vários documentos (MDI). Em ambos os casos, não é conveniente usar os bytes extras especificados no CreateWindow função ou estrutura de classe pelos dois motivos a seguir:
- Um aplicativo pode não saber quantos bytes extras estão disponíveis ou como o espaço está sendo usado. Usando propriedades de janela, o aplicativo pode associar dados a uma janela sem acessar os bytes extras.
- Um aplicativo deve acessar os bytes extras usando deslocamentos. No entanto, as propriedades da janela são acessadas por seus identificadores de cadeia de caracteres, não por deslocamentos.
Para obter mais informações sobre subclassificação, consulte Subclassificação de Procedimentos de Janela. Para obter mais informações sobre janelas MDI, consulte Multiple Document Interface.
Atribuindo propriedades da janela
A função SetProp atribui uma propriedade window e seu identificador de cadeia de caracteres a uma janela. A função GetProp recupera a propriedade window identificada pela cadeia de caracteres especificada. A função RemoveProp destrói a associação entre uma janela e uma propriedade window, mas não destrói os dados em si. Para destruir os dados em si, use a função apropriada para liberar o identificador que é retornado por RemoveProp.
Enumerando propriedades da janela
As funções EnumProps e EnumPropsEx enumeram todas as propriedades de uma janela usando uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações sobre a função de retorno de chamada, consulte PropEnumProc.
EnumPropsEx inclui um parâmetro adicional para dados definidos pela aplicação usados na função de retorno de chamada. Para obter mais informações sobre a função de retorno de chamada, consulte PropEnumProcEx.