CDC::E&numObjectsnbsp;

int EnumObjects ( int nObjectType, int ( CALLBACK exportação * lpfn ) ( LPVOID, LPARAM ), LPARAM lpData );

Valor de retorno

Especifica o último valor retor&nado pela função callback. Seu significado é usuário-defined.nbsp;

Parâmetros

nObjectType

Especifica o tipo de objeto. Ele pode ter os valores OBJ_BRUSH ou OBJ_PEN.

lpfn

É o endereço da instância do procedimento da função de retorno de chamada fornecido do aplicativo. Consulte a seção "Comentários" abaixo.

lpData

Aponta para dados application-supplied. Os dados são passados para a função callback along with as informações do objeto.

Observações

Enumera as canetas e pincéis disponível em um contexto de dispositivo. Para cada objeto de um determinado tipo, a função de retorno de chamada que você passa é chamada com as informações para esse objeto. O sistema chama a função de retorno de chamada até que não há mais objetos ou o função callback retorna 0.

Observe que novos recursos do Microsoft Visual C++ permitem que você use uma função comum como a função passada para EnumObjects. O endereço passado para EnumObjects é um ponteiro para uma função exportada com exportação e com a Convenção de chamada do Pascal. No modo proteger aplicativos, você não precisará criar essa função com o Windows MakeProcInstance funcionar ou livre a função após o uso com o FreeProcInstance função do Windows.

Você também não deve exportar o nome de função em uma instrução de EXPORTS no arquivo de definição de módulo do seu aplicativo. Você pode usar o modificador de função EXPORTAR , como em

int retorno de chamada de exportação AFunction( LPSTR, LPSTR );

para fazer com que o compilador para emitir o registro de exportação adequado para exportação por nome sem serrilhado. Isso funciona para a maioria das necessidades. Para alguns casos especiais, tais como Exportando uma função por ordinal ou serrilhado a exportação, você ainda precisará usar uma instrução de EXPORTS em um arquivo de definição de módulo.

Para compilar programas Microsoft Foundation, você normalmente usará o /GA e opções de compilador /GEs. A opção de compilador Publications não é usada com o Microsoft Foundation classes. (Se você usar o Windows função MakeProcInstance, você precisará converter explicitamente o ponteiro de função retornado de FARPROC para o tipo necessário nesta API.) Retorno de chamada registro interfaces agora são tipo-safe (você deve passar em um ponteiro de função que aponta para o direito tipo de função para o retorno de chamada específico).

Observe também que todas as funções de retorno de chamada devem interceptar exceções Microsoft Foundation antes de retornar ao Windows, uma vez que exceções não podem ser lançadas através de limites de retorno de chamada. Para obter mais informações sobre exceções, consulte o artigo exceções no Guia do programador do Visual C++.

Visão geral do CDCMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp; ::EnumObjects

Index