-- winapiex - a binary Lua 5.1 extension for Windows.
-- Author: Valentin Schmidt
-- Version: 0.3


--------------------------------------------------
winapiex.findWindow (string|nil className, string|nil windowName, integer|nil hwndParent) -> int HWND
--------------------------------------------------
-- Retrieves a handle to a window whose class name and window name match the
-- specified strings. The function implements the win api function FindWindowEx(), 
-- but ignores the 'hwndChildAfter' parameter (i.e. it's always NULL).
-- See https://msdn.microsoft.com/de-de/library/windows/desktop/ms633500(v=vs.85).aspx


--------------------------------------------------
winapiex.getActiveWindow () -> int HWND
--------------------------------------------------
-- Retrieves the window handle to the active window attached to the calling
-- thread's message queue.
-- See https://msdn.microsoft.com/de-de/library/windows/desktop/ms646292(v=vs.85).aspx


--------------------------------------------------
winapiex.getIconForFileType (string fileType) -> string bmpData
--------------------------------------------------
-- Returns the system's default icon for specified filetype (e.g. "png") as BMP 
-- data.


--------------------------------------------------
winapiex.getKeyState (integer virtKey) -> int status
--------------------------------------------------
-- Retrieves the status of the specified virtual key. The status specifies
-- whether the key is up, down, or toggled (on, off-alternating each time the 
-- key is pressed).
-- See https://msdn.microsoft.com/de-de/library/windows/desktop/ms646301(v=vs.85).aspx


--------------------------------------------------
winapiex.getLongPathName (string shortPath) -> string longPath
--------------------------------------------------
-- Returns long path for short DOS 8.3 path.


--------------------------------------------------
winapiex.getSystemMetrics (int index) -> int result
--------------------------------------------------
-- Retrieves the specified system metric or system configuration setting.
-- Note that all dimensions retrieved by GetSystemMetrics are in pixels.
-- See https://msdn.microsoft.com/en-us/library/windows/desktop/ms724385(v=vs.85).aspx


--------------------------------------------------
winapiex.getWindowRect (int HWND) -> int left, top, right, bottom
--------------------------------------------------
-- Retrieves the dimensions of the bounding rectangle of the specified window.
-- The dimensions are given in screen coordinates that are relative to the
-- upper-left corner of the screen.
-- See https://msdn.microsoft.com/de-de/library/windows/desktop/ms633519(v=vs.85).aspx


--------------------------------------------------
winapiex.msgListen (int HWND, table msgTypes, string globalLuaFuncName)
--------------------------------------------------
-- Listens to win message of the specified type sent to the window with the
-- specified HWND and forwards them to lua callback function. If callback 
-- function returns true, the message is blocked, otherwise (if it returns 
-- anything else or nothing) the message is forwarded to the original receiver 
-- window.


--------------------------------------------------
winapiex.sendCopyData (int HWND, string data) -> int result
--------------------------------------------------
-- Sends data as WM_COPYDATA message to window with specified HWND.


--------------------------------------------------
winapiex.sendMsg (int HWND, int msg, int wParam, int lParam) -> int result
--------------------------------------------------
-- Sends the specified message to a window or windows. The SendMessage function
-- calls the window procedure for the specified window and does not return until
-- the window procedure has processed the message.
-- See https://msdn.microsoft.com/de-de/library/windows/desktop/ms644950(v=vs.85).aspx


--------------------------------------------------
winapiex.setForegroundWindow (int HWND) -> int result
--------------------------------------------------
-- Brings the thread that created the specified window into the foreground and
-- activates the window.
-- See https://msdn.microsoft.com/de-de/library/windows/desktop/ms633539(v=vs.85).aspx


--------------------------------------------------
winapiex.setWindowLong (int HWND, int valueIndex, int newValue) -> int result
--------------------------------------------------
-- Changes an attribute of the specified window. The function also sets the
-- 32-bit (long) value at the specified.
-- See https://msdn.microsoft.com/de-de/library/windows/desktop/ms633591(v=vs.85).aspx


--------------------------------------------------
winapiex.tcmItemRect (int HWND, int index) -> int left, top, right, bottom
--------------------------------------------------
-- Retrieves the bounding rectangle for a tab in a tab control.
-- See https://msdn.microsoft.com/en-us/library/windows/desktop/bb760665(v=vs.85).aspx