如何：實作回呼函式

發行項
08/16/2023

下列程序及範例示範 Managed 應用程式 (使用平台叫用) 如何將每個視窗的控制碼值列印到本機電腦上。具體而言，程序和範例會使用 EnumWindows 函式以逐步執行視窗的清單，並使用 Managed 回呼函式 (具名回呼) 以列印視窗控制代碼的值。

若要實作回撥函式

進一步進行實作前，請先查看 EnumWindows 函式的簽章。 EnumWindows 具有下列簽章：
```
BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)
```
此函式需要進行回呼的一個線索在於 lpEnumFunc 引數。 lp (長度指標) 前置詞與 Func 後置詞的結合出現在引數名稱中的情況相當普遍，其會將指標帶到回呼函式。如需 Win32 函式的相關文件，請參閱 Microsoft Platform SDK。
建立 Managed 回撥函式。此範例會宣告稱為 CallBack 的委派型別，其採用兩個引數 (hwnd 和 lparam)。第一個引數是視窗的控制代碼；第二個引數則由應用程式定義。在此版本中，兩個引數都必須是整數。

回撥函式通常傳回非零值即表示成功，傳回零則表示失敗。此範例將傳回的值明確設定為 true 以繼續列舉。
建立委派，並將其以引數方式傳遞至 EnumWindows 函式。平台叫用會自動將委派轉換成熟悉的回撥格式。
請確定記憶體回收行程不會在回撥函式完成其工作前，回收該委派。當您將委派以參數 (或結構中的欄位) 方式傳遞時，其將在呼叫期間保持為未回收。因此，在以下列舉範例中，回撥函式在呼叫傳回前即會完成該工作，且不需要 Managed 呼叫端進行額外的動作。

但是，如果呼叫傳回後仍然可以叫用回撥函式，則 Managed 呼叫端必須採取步驟，以確保在回撥函式結束前，委派仍保持未回收。如需範例，請參閱GCHandle 範例 (機器翻譯)。

範例

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();  
}

共用方式為

如何：實作回呼函式

若要實作回撥函式

範例

另請參閱

其他資源