85 lines
8.3 KiB
C++
85 lines
8.3 KiB
C++
// function: windows utilities
|
||
//
|
||
// author: Gongbing
|
||
//
|
||
// date: 2018-11-05
|
||
//
|
||
//
|
||
#pragma once
|
||
#include <string>
|
||
#ifndef _INCLUDED_REF_
|
||
#define _INCLUDED_REF_
|
||
#include "../ref/ref.h"
|
||
#endif
|
||
|
||
#define MINI_BUF_LEN 40
|
||
|
||
namespace win_util
|
||
{
|
||
// parameters of result:
|
||
// data: HWND value
|
||
// len: unused, always be ZERO
|
||
// total: unused, always be ZERO
|
||
// flag: always be DATA_FLAG_FINAL
|
||
// param: as same as user_data
|
||
PORT_API(void) find_window(inter_module_data::set_data result, void* user_data);
|
||
|
||
// find window decided by one or more parameters in following
|
||
// found - to receive the result
|
||
// num - array number of found
|
||
// parent - the parent window, not check if NULL
|
||
// cls_name - class name of the window, not check if NULL
|
||
// title - title of the window, not check if NULL
|
||
// proc_id - process id that the window belong, not check if ZERO
|
||
// thrd_id - thread id that the window belong, not check if ZERO
|
||
// win_id - the window ID, not check if ZERO
|
||
//
|
||
// return - number of found window
|
||
PORT_API(int) find_window(HWND *found, DWORD num, HWND parent = NULL, const wchar_t* cls_name = NULL, const wchar_t* title = NULL, DWORD proc_id = 0, DWORD thrd_id = 0, DWORD win_id = 0);
|
||
PORT_API(bool) bring_window_topmost(HWND hwnd, DWORD persist_milliseconds = -1);
|
||
|
||
PORT_API(bool) attr_str_2_id(const wchar_t* id_str, int* id); // return 0 is none
|
||
PORT_API(bool) attr_str_from_id(int attr_id, wchar_t buf[MINI_BUF_LEN]); // return NULL is none
|
||
PORT_API(bool) get_attr_by_index(int index, int* attr_id, wchar_t style_str[MINI_BUF_LEN]);
|
||
|
||
PORT_API(bool) style_str_2_id(const wchar_t* style_str, int* id);
|
||
PORT_API(bool) style_id_2_str(int style, wchar_t buf[MINI_BUF_LEN]);
|
||
PORT_API(bool) get_style_by_index(int index, int* style_id, wchar_t style_str[MINI_BUF_LEN]); // return false if index out of range
|
||
|
||
PORT_API(bool) styleex_str_2_id(const wchar_t* styleex_str, int* id);
|
||
PORT_API(bool) styleex_id_2_str(int style, wchar_t buf[MINI_BUF_LEN]);
|
||
PORT_API(bool) get_styleex_by_index(int index, int* styleex_id, wchar_t styleex_str[MINI_BUF_LEN]); // return false if index out of range
|
||
|
||
PORT_API(bool) msg_str_2_id(const wchar_t* msg_str, int* id);
|
||
PORT_API(bool) msg_id_2_str(int style, wchar_t buf[MINI_BUF_LEN]);
|
||
PORT_API(bool) get_msg_by_index(int index, int* msg_id, wchar_t msg_str[MINI_BUF_LEN]); // return false if index out of range
|
||
|
||
// snap
|
||
enum _finger_print_pos
|
||
{
|
||
FINGER_PRINT_POS_LT = 1, // left-top
|
||
FINGER_PRINT_POS_LB, // left-bottom
|
||
FINGER_PRINT_POS_RT, // right-top
|
||
FINGER_PRINT_POS_RB, // right-bottom
|
||
FINGER_PRINT_POS_MID, // center of horizontal and vertical
|
||
};
|
||
PORT_API(HBITMAP) snap_window_by_gdi(HWND hwnd = NULL, const wchar_t* finger_print = NULL, _finger_print_pos pos = FINGER_PRINT_POS_LT); // call DeleteObject to free the returned object
|
||
PORT_API(bool) save_bitmap_to_file(HBITMAP hbmp, const wchar_t* path_file, const wchar_t* img_type = L"png");
|
||
PORT_API(ATOM) register_window(const wchar_t* cls, WNDPROC proc, HINSTANCE inst, UINT icon, UINT icon_small, DWORD style = CS_HREDRAW | CS_VREDRAW, const wchar_t* cursor = /*IDC_ARROW*/MAKEINTRESOURCEW(32512));
|
||
|
||
// use the main window icon as tray icon if icon was NULL
|
||
// in tray message 'tray_msg', the parameter 'lParam' is a mouse event code, e.g. WM_RBUTTONUP. more see NOTIFYICONDATAW
|
||
PORT_API(bool) add_tray_icon(int tray_id, HWND main_wnd, UINT tray_msg, const wchar_t* tray_tips, HICON icon = NULL);
|
||
PORT_API(bool) remove_tray_icon(int tray_id, HWND main_wnd);
|
||
PORT_API(bool) set_tray_icon_tips(int tray_id, HWND main_wnd, const wchar_t* tips);
|
||
PORT_API(bool) show_balloon(int tray_id, HWND main_wnd, const wchar_t* tips, const wchar_t* title, DWORD dwTimeout, HICON hIcon = NULL, DWORD dwInfoFlag = NIIF_USER);
|
||
PORT_API(UINT_PTR) reg_full_screen_notify(HWND main_wnd, UINT notify_msg, bool reg = true);
|
||
PORT_API(int) get_taskbar_pos(LPRECT r = NULL); // return ABE_LEFT, ABE_TOP, ABE_BOTTOM or ABE_RIGHT
|
||
|
||
// data - (wchar_t*)
|
||
// len - words of 'data'
|
||
// total - always be 0
|
||
PORT_API(bool) error_message(int err_code, inter_module_data::set_data set_unic_str, void* param);
|
||
};
|
||
|