API Documentation for SendMessage, GetTickCount, PostQuitMessage,

GetMessagePos, GetMessageTime.
This commit is contained in:
Douglas Ridgway 1998-10-25 09:20:30 +00:00 committed by Alexandre Julliard
parent 51e3046932
commit efaa573501
2 changed files with 85 additions and 6 deletions

View File

@ -1258,6 +1258,11 @@ static void MSG_CallWndProcHook32( LPMSG32 pmsg, BOOL32 bUnicode )
/********************************************************************** /**********************************************************************
* PostThreadMessage32A (USER32.422) * PostThreadMessage32A (USER32.422)
*
* BUGS
*
* Thread-local message queues are not supported.
*
*/ */
BOOL32 WINAPI PostThreadMessage32A(DWORD idThread , UINT32 message, BOOL32 WINAPI PostThreadMessage32A(DWORD idThread , UINT32 message,
WPARAM32 wParam, LPARAM lParam ) WPARAM32 wParam, LPARAM lParam )
@ -1321,11 +1326,32 @@ LRESULT WINAPI SendMessage32A( HWND32 hwnd, UINT32 msg, WPARAM32 wParam,
/*********************************************************************** /***********************************************************************
* SendMessage32W (USER32.459) * SendMessage32W (USER32.459) Send Window Message
*
* Sends a message to the window procedure of the specified window.
* SendMessage() will not return until the called window procedure
* either returns or calls ReplyMessage().
*
* Use PostMessage() to send message and return immediately. A window
* procedure may use InSendMessage() to detect
* SendMessage()-originated messages.
*
* Applications which communicate via HWND_BROADCAST may use
* RegisterWindowMessage() to obtain a unique message to avoid conflicts
* with other applications.
*
* CONFORMANCE
*
* ECMA-234, Win32
*/ */
LRESULT WINAPI SendMessage32W( HWND32 hwnd, UINT32 msg, WPARAM32 wParam, LRESULT WINAPI SendMessage32W(
LPARAM lParam ) HWND32 hwnd, /* Window to send message to. If HWND_BROADCAST,
{ the message will be sent to all top-level windows. */
UINT32 msg, /* message */
WPARAM32 wParam, /* message parameter */
LPARAM lParam /* additional message parameter */
) {
WND * wndPtr; WND * wndPtr;
WND **list, **ppWnd; WND **list, **ppWnd;
LRESULT ret; LRESULT ret;
@ -1416,6 +1442,8 @@ LRESULT WINAPI SendMessageTimeout32W( HWND32 hwnd, UINT32 msg, WPARAM32 wParam,
* *
* Is supposed to return BOOL under Win32. * Is supposed to return BOOL under Win32.
* *
* Thread-local message queues are not supported.
*
* CONFORMANCE * CONFORMANCE
* *
* ECMA-234, Win32 * ECMA-234, Win32
@ -1755,7 +1783,7 @@ LONG WINAPI DispatchMessage32A( const MSG32* msg )
/*********************************************************************** /***********************************************************************
* DispatchMessage32W (USER32.142) * DispatchMessage32W (USER32.142) Process Message
* *
* Process the message specified in the structure *_msg_. * Process the message specified in the structure *_msg_.
* *
@ -1850,7 +1878,13 @@ WORD WINAPI RegisterWindowMessage32W( LPCWSTR str )
/*********************************************************************** /***********************************************************************
* GetTickCount (USER.13) (KERNEL32.299) * GetTickCount (USER.13) (KERNEL32.299) System Time
* Returns the number of milliseconds, modulo 2^32, since the start
* of the current session.
*
* CONFORMANCE
*
* ECMA-234, Win32
*/ */
DWORD WINAPI GetTickCount(void) DWORD WINAPI GetTickCount(void)
{ {

View File

@ -738,6 +738,17 @@ void WINAPI PostQuitMessage16( INT16 exitCode )
/*********************************************************************** /***********************************************************************
* PostQuitMessage32 (USER32.421) * PostQuitMessage32 (USER32.421)
*
* PostQuitMessage() posts a message to the system requesting an
* application to terminate execution. As a result of this function,
* the WM_QUIT message is posted to the application, and
* PostQuitMessage() returns immediately. The exitCode parameter
* specifies an application-defined exit code, which appears in the
* _wParam_ parameter of the WM_QUIT message posted to the application.
*
* CONFORMANCE
*
* ECMA-234, Win32
*/ */
void WINAPI PostQuitMessage32( INT32 exitCode ) void WINAPI PostQuitMessage32( INT32 exitCode )
{ {
@ -899,6 +910,24 @@ BOOL32 WINAPI GetInputState32(void)
/*********************************************************************** /***********************************************************************
* GetMessagePos (USER.119) (USER32.272) * GetMessagePos (USER.119) (USER32.272)
*
* The GetMessagePos() function returns a long value representing a
* cursor position, in screen coordinates, when the last message
* retrieved by the GetMessage() function occurs. The x-coordinate is
* in the low-order word of the return value, the y-coordinate is in
* the high-order word. The application can use the MAKEPOINT()
* macro to obtain a POINT structure from the return value.
*
* For the current cursor position, use GetCursorPos().
*
* RETURNS
*
* Cursor position of last message on success, zero on failure.
*
* CONFORMANCE
*
* ECMA-234, Win32
*
*/ */
DWORD WINAPI GetMessagePos(void) DWORD WINAPI GetMessagePos(void)
{ {
@ -911,6 +940,22 @@ DWORD WINAPI GetMessagePos(void)
/*********************************************************************** /***********************************************************************
* GetMessageTime (USER.120) (USER32.273) * GetMessageTime (USER.120) (USER32.273)
*
* GetMessageTime() returns the message time for the last message
* retrieved by the function. The time is measured in milliseconds with
* the same offset as GetTickCount().
*
* Since the tick count wraps, this is only useful for moderately short
* relative time comparisons.
*
* RETURNS
*
* Time of last message on success, zero on failure.
*
* CONFORMANCE
*
* ECMA-234, Win32
*
*/ */
LONG WINAPI GetMessageTime(void) LONG WINAPI GetMessageTime(void)
{ {