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 [僅限桌面應用程式] |
標頭 |
|