SetProp

O SetProp função adiciona uma nova entrada ou altera uma entrada existente na lista a propriedade da janela especificada. A função adiciona uma nova entrada à lista se a Cadeia de caracteres especificada não existir já na lista. A nova entrada contém a Cadeia de caracteres e a alça. Caso contrário, a função substitui o atual identificador do seqüência de caracteres com o identificador especificado.

(BOOL SetProp HWND  hWnd, / / identificador da janelaLPCTSTRlpString, / / átomo ou o endereço da Cadeia de caracteresLidar comhData / / manipular dados);
 

Parâmetros

hWnd

Identificador para a janela cuja lista Propriedade recebe a nova entrada.

lpString

Ponteiro para uma Cadeia de caracteres terminada por caractere nulo ou contém um átomo que identifica uma seqüência de caracteres. Se este parâmetro for um átomo, ele deverá ser um átomo global criado por um chamar anterior para o GlobalAddAtom função. O átomo, de 16-bit valor, deve ser colocado no baixo palavra de ordem lpString; o alto palavra ordem deve ser zero.

hData

Identificador para os dados a serem copiados para a lista de propriedade. O identificador dados pode identificar qualquer valor útil para o aplicativo.

Retornar valores

Se o identificador dados e string são adicionados à lista de propriedade, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Antes de destruir uma janela (isto é, antes de processar o WM_DESTROY mensagem), um aplicativo deve remover todas as entradas que adicionou à lista de propriedade. O aplicativo deve usar a RemoveProp função para remover as entradas.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral da janela Propriedades, propriedade janela funções, EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp

Index