Como: Implementar funções callback
O procedimento e o exemplo a seguir demonstram como um aplicativo gerenciado, usando invocação de plataforma, pode imprimir o valor do identificador para cada janela no computador local.Especificamente, o procedimento e exemplo usam o EnumWindowsfunção para percorrer a lista de janelas e uma função de retorno de chamada gerenciado (viasa nomeada) para imprimir o valor do identificador de janela.
Para implementar uma função de retorno de chamada
Examinar a assinatura para o EnumWindows função antes de ficar ainda mais com a implementação.EnumWindows tem a seguinte assinatura:
BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)
Uma pista que esta função exige um retorno de chamada é a presença do lpEnumFunc argumento.É comum ver o LP prefixo (ponteiro longo) combinado com o Func sufixo no nome de argumentos que levam um ponteiro para uma função de retorno de chamada.Para obter documentação sobre as funções do Win32, consulte Microsoft plataforma SDK.
Crie a função de retorno de chamada gerenciado.O exemplo declara um tipo de delegado, chamado CallBack, que leva dois argumentos ()hwnd and lParam).O primeiro argumento é um identificador para a janela; o segundo argumento é definido pelo aplicativo.Nesta versão, ambos os argumentos devem ser inteiros.
Funções de retorno de chamada geralmente retornam valores diferentes de zero para indicar sucesso e zero para indicar falha.Este exemplo define explicitamente o valor retornado como True para continuar a enumeração.
Criar um delegado e passá-lo sistema autônomo um argumento para o EnumWindows função.Invocação de plataforma converte o delegado em um formato familiar de retorno de chamada automaticamente.
Certifique-se de que o coletor de lixo não recupera o delegado antes que a função de retorno de chamada conclui seu trabalho.Quando você passar um delegado sistema autônomo um parâmetro ou passa um delegado contido sistema autônomo um campo em uma estrutura, ela permanece uncollected por duração da telefonar.Então, sistema autônomo é o caso no exemplo a seguir enumeração, a função de retorno de telefonar conclui seu trabalho antes da telefonar retorna e não requer nenhuma ação adicional pelo chamador gerenciado.
Se, no entanto, a função de retorno de telefonar pode ser telefonar após a telefonar retorna, o chamador gerenciado deve seguir as etapas para garantir que o delegado permaneça uncollected até que a função de retorno de telefonar seja concluída.Para obter informações detalhadas sobre como evitar a coleta de lixo, consulte marshaling de interoperabilidade com invocação de plataforma.
Exemplo
Imports System
Imports System.Runtime.InteropServices
Public Delegate Function CallBack( _
hwnd As Integer, lParam As Integer) As Boolean
Public Class EnumReportApp
Declare Function EnumWindows Lib "user32" ( _
x As CallBack, y As Integer) As Integer
Public Shared Sub Main()
EnumWindows(AddressOf EnumReportApp.Report, 0)
End Sub 'Main
Public Shared Function Report(hwnd As Integer, lParam As Integer) _
As Boolean
Console.Write("Window handle is ")
Console.WriteLine(hwnd)
Return True
End Function 'Report
End Class 'EnumReportApp
using System;
using System.Runtime.InteropServices;
public delegate bool CallBack(int hwnd, int lParam);
public class EnumReportApp {
[DllImport("user32")]
public static extern int EnumWindows(CallBack x, int y);
public static void Main()
{
CallBack myCallBack = new CallBack(EnumReportApp.Report);
EnumWindows(myCallBack, 0);
}
public static bool Report(int hwnd, int lParam) {
Console.Write("Window handle is ");
Console.WriteLine(hwnd);
return true;
}
}
using namespace System::Runtime::InteropServices;
// A delegate type.
__delegate bool CallBack(int hwnd, int lParam);
// Managed type with the method to call.
__gc class EnumReport
{
// Report the window handle.
public:
bool Report(int hwnd, int lParam) {
Console::Write(L"Window handle is ");
Console::WriteLine(hwnd);
return true;
}
};
[DllImport("user32")]
extern "C" int EnumWindows(CallBack* x, int y);
void main(void) {
EnumReport* er = new EnumReport;
CallBack* myCallBack = new CallBack(er, &EnumReport::Report);
EnumWindows(myCallBack, 0);
}