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.

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.

unnamedParam3

Tipo: HANDLE

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

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.

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 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

EnumPropsEx

de referência de

RemoveProp

SetProp

Propriedades da janela