Função EnumPropsExA (winuser.h)

Artigo
11/20/2024

Enumera todas as entradas na lista de propriedades de uma janela passando-as, uma a uma, para a função de retorno de chamada especificada. EnumPropsEx continua até que a última entrada seja enumerada ou a função de retorno de chamada retorne FALSE.

Sintaxe

int EnumPropsExA(
  [in] HWND            hWnd,
  [in] PROPENUMPROCEXA lpEnumFunc,
  [in] LPARAM          lParam
);

Parâmetros

[in] hWnd

Tipo: HWND

Um identificador para a janela cuja lista de propriedades deve ser enumerada.

[in] lpEnumFunc

Tipo: PROPENUMPROCEX

Um ponteiro para a função de retorno de chamada. Para obter mais informações sobre a função de retorno de chamada, consulte a função PropEnumProcEx.

[in] lParam

Tipo: LPARAM

Dados definidos pelo aplicativo a serem passados para a função de retorno de chamada.

Valor de retorno

Tipo: int

O valor retornado especifica o último valor retornado pela função de retorno de chamada. Ele será -1 se a função não encontrar uma propriedade para enumeração.

Observações

Um aplicativo pode remover apenas as propriedades que adicionou. Ele não deve remover as propriedades adicionadas por outros aplicativos ou pelo próprio sistema.

Exemplos

Para obter um exemplo, consulte Propriedades da Janela de Listagem para um determinadode janela.

Nota

O cabeçalho winuser.h define EnumPropsEx 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)
biblioteca	User32.lib
de DLL	User32.dll

Consulte também

Conceitual

PropEnumProcEx

de referência de

Propriedades da janela

Compartilhar via