Procedura: implementare funzioni di callback
Nella procedura e nell'esempio che seguono viene illustrato come un'applicazione gestita, utilizzando platform invoke, può visualizzare l'handle di tutte le finestre del computer locale. In particolare, nella procedura e nell'esempio vengono utilizzate la funzione EnumWindows per scorrere l'elenco di finestre e una funzione di callback gestita (denominata CallBack) per visualizzare il valore dell'handle di finestra.
Per implementare una funzione di callback
Prima di procedere con l'implementazione della funzione EnumWindows, osservarne la firma. EnumWindows ha la seguente firma:
BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)La presenza dell'argomento lpEnumFunc indica che questa funzione richiede un callback. È frequente vedere il prefisso lp (puntatore long) combinato con il suffisso Func nel nome di argomenti che accettano un puntatore a una funzione di callback. Per la documentazione sulle funzioni di Win32, vedere Microsoft Platform SDK.
Creare la funzione di callback gestita. Nell'esempio viene dichiarato un tipo delegato, denominato CallBack, che accetta due argomenti (hwnd e lparam). Il primo argomento è un handle di finestra. Il secondo argomento è definito dall'applicazione. In questa versione entrambi gli argomenti devono essere integer.
Le funzioni di callback restituiscono in genere valori diversi da zero per indicare l'esito positivo e zero per indicare l'esito negativo. In questo esempio il valore restituito viene impostato in modo esplicito su true per continuare l'enumerazione.
Creare un delegato e passarlo come argomento alla funzione EnumWindows. Con platform invoke, il delegato viene convertito automaticamente in un formato di callback conosciuto.
Assicurarsi che Garbage Collector non reclami il delegato prima che la funzione di callback abbia completato il proprio compito. Quando si passa un delegato come parametro o si passa un delegato contenuto come campo in una struttura, questo non viene interessato dalla procedura di collection fino al termine della chiamata. Pertanto, come avviene nell'esempio di enumerazione riportato di seguito, la funzione di callback completa il proprio compito prima del termine della chiamata e non richiede ulteriori operazioni da parte del chiamante gestito.
Se la funzione di callback può essere chiamata dopo il termine della chiamata, il chiamante gestito dovrà comunque predisporre quanto necessario affinché il delegato non sia interessato dalla procedura di collection fino al termine della funzione di callback. Per informazioni dettagliate sulla prevenzioni delle procedure di Garbage Collection, vedere Marshalling di interoperabilità con platform invoke.
Esempio
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;
using namespace System::Runtime::InteropServices;
// A delegate type.
delegate bool CallBack(int hwnd, int lParam);
// Managed type with the method to call.
ref class EnumReport
{
// Report the window handle.
public:
[DllImport("user32")]
static int EnumWindows(CallBack^ x, int y);
static void Main()
{
EnumReport^ er = gcnew EnumReport;
CallBack^ myCallBack = gcnew CallBack(&EnumReport::Report);
EnumWindows(myCallBack, 0);
}
static bool Report(int hwnd, int lParam)
{
Console::Write(L"Window handle is ");
Console::WriteLine(hwnd);
return true;
}
};
int main()
{
EnumReport::Main();
}