搭配 EnumProps 函式使用的應用程式定義回呼函式。 函式會從視窗的屬性清單中接收屬性專案。 PROPENUMPROC 類型會定義這個回呼函式的指標。 PropEnumProc 是應用程式定義函式名稱的佔位元元。
語法
PROPENUMPROCA Propenumproca;
BOOL Propenumproca(
HWND unnamedParam1,
LPCSTR unnamedParam2,
HANDLE unnamedParam3
)
{...}
參數
unnamedParam1
類型:HWND
要列舉其屬性清單之視窗的句柄。 此參數通常命名為 hWnd。
unnamedParam2
類型:LPCTSTR
屬性清單專案的字串元件。 這是透過呼叫 setProp 函式,將 屬性新增至視窗屬性清單時所指定的字串,以及數據句柄。 此參數通常命名為 lpString。
unnamedParam3
類型:HANDLE
數據的句柄。 這個句柄是屬性清單項目的數據元件。 此參數通常命名為 hData。
傳回值
類型:BOOL
傳回 TRUE,以繼續屬性清單列舉。
傳回 FALSE 以停止屬性清單列舉。
言論
注意
參數定義在標頭中,沒有名稱: typedef BOOL (CALLBACK* PROPENUMPROCA)(HWND, LPCSTR, HANDLE);。 因此,語法區塊會將它們列為 unnamedParam1 - unnamedParam3。 您可以在應用程式中為這些參數命名任何名稱。 但是,它們通常按照參數描述中所示命名。
下列限制適用於此回呼函式:
- 回呼函式可以呼叫 removeProp 函式
。 不過,RemoveProp 只能透過回調函式的參數移除傳遞至回呼函式的屬性。 - 回呼函式不應該嘗試新增屬性。
注意
winuser.h 標頭會將 PROPENUMPROC 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winuser.h (包括 Windows.h) |
另請參閱
概念
參考