Função de retorno de chamada PROPENUMPROCA (winuser.h)

Uma função de retorno de chamada definida pelo aplicativo usada com a função EnumProps . A função recebe entradas de propriedade da lista de propriedades de uma janela. O tipo PROPENUMPROC define um ponteiro para essa função de retorno de chamada. PropEnumProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PROPENUMPROCA Propenumproca;

BOOL Propenumproca(
  HWND unnamedParam1,
  LPCSTR unnamedParam2,
  HANDLE unnamedParam3
)
{...}

Parâmetros

unnamedParam1

Tipo: HWND

Um identificador para a janela cuja lista de propriedades está sendo enumerada.

unnamedParam2

Tipo: LPCTSTR

O componente de cadeia de caracteres de uma entrada de lista de propriedades. Essa é a cadeia de caracteres especificada, juntamente com um identificador de dados, quando a propriedade foi adicionada à lista de propriedades da janela por meio de uma chamada para a função SetProp.

unnamedParam3

Tipo: HANDLE

Um identificador para os dados. Esse identificador é o componente de dados de uma entrada de lista de propriedades.

Valor de retorno

Tipo: BOOL

Retorne TRUE para continuar a enumeração da lista de propriedades.

Retorne FALSE para interromper a enumeração da lista de propriedades.

Observações

As seguintes restrições se aplicam a essa função de retorno de chamada:

• A função de retorno de chamada pode chamar a função RemoveProp. No entanto, RemoveProp pode remover apenas a propriedade passada para a função de retorno de chamada por meio dos parâmetros da função de retorno de chamada.
• A função de retorno de chamada não deve tentar adicionar propriedades.

Nota

O cabeçalho winuser.h define PROPENUMPROC como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)

Consulte também

Conceitual

EnumProps

de referência de

RemoveProp

SetProp

Propriedades da janela