Compartilhar via


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

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

Sintaxe

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

Parâmetros

unnamedParam1

Tipo: HWND

Um identificador para a janela cuja lista de propriedades está sendo enumerada. Esse parâmetro normalmente é chamado de hWnd.

unnamedParam2

Tipo: LPTSTR

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. Esse parâmetro normalmente é chamado de lpString.

unnamedParam3

Tipo: HANDLE

Um identificador para os dados. Esse identificador é o componente de dados de uma entrada de lista de propriedades. Esse parâmetro normalmente é chamado de hData.

unnamedParam4

Tipo: ULONG_PTR

Dados definidos pelo aplicativo. Esse é o valor especificado como o parâmetro lParam da chamada para EnumPropsEx que iniciou a enumeração. Esse parâmetro normalmente é chamado de dwData.

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

Nota

Os parâmetros são definidos no cabeçalho sem nomes: typedef BOOL (CALLBACK* PROPENUMPROCEXA)(HWND, LPSTR, HANDLE, ULONG_PTR);. Portanto, o bloco de sintaxe os lista como unnamedParam1 - unnamedParam4. Você pode nomear esses parâmetros em seu aplicativo. No entanto, eles geralmente são nomeados conforme mostrado nas descrições de parâmetro.

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 PROPENUMPROCEX como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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

Propriedades da janela

de referência de

EnumPropsEx

RemoveProp

SetProp