EM_GETHANDLE訊息

取得目前為多行編輯控制項文字配置的記憶體控制碼。

參數

wParam

未使用;必須是零。

lParam

未使用;必須是零。

傳回值

傳回值是記憶體控制碼，可識別保留編輯控制項內容的緩衝區。 如果發生錯誤，例如將訊息傳送至單行編輯控制項，則傳回值為零。

備註

如果函式成功，應用程式可以將傳回值轉換成 HLOCAL 並將它傳遞至 LocalLock，以存取編輯控制項的內容。 LocalLock 會根據 ANSI 或 Unicode 函式是否建立控制項，傳回緩衝區的指標，該緩衝區是 CHARs 或 WCHARs 的 Null 終止陣列。 例如，如果使用 CreateWindowExA ，則緩衝區是 CHAR的陣列，但如果使用 CreateWindowExW ，則緩衝區是 WCHARs 的陣列。 應用程式可能不會變更緩衝區的內容。 若要解除鎖定緩衝區，應用程式會先呼叫 LocalUnlock ，再允許編輯控制項接收新訊息。

注意

針對第 6 版Comctl32.dll，不論 ANSI 或 Unicode 函式是否建立編輯控制項，緩衝區一律包含 WCHAR的陣列。 如需 DLL 版本的詳細資訊，請參閱 一般控制項版本。

如果您的應用程式無法遵守 EM_GETHANDLE所加加的限制，請使用 GetWindowTextLength 和 GetWindowText 函式，將編輯控制項的內容複寫到應用程式提供的緩衝區。

豐富編輯： 不支援 EM_GETHANDLE 訊息。 豐富的編輯控制項不會將文字儲存為簡單的字元陣列。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	Winuser.h (包括 Windows.h)

另請參閱

參考

EM_SETHANDLE

其他資源

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock