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

Artigo
08/27/2023

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

PROPENUMPROCW Propenumprocw;

BOOL Propenumprocw(
  HWND unnamedParam1,
  LPCWSTR unnamedParam2,
  HANDLE unnamedParam3
)
{...}

Parâmetros

unnamedParam1

Digite: 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 retornado

Tipo: BOOL

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

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

Comentários

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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)