Context Navigation

source: trunk/include/helpers/winh.h@ 108

Visit:

Last change on this file since 108 was 108, checked in by umoeller, 24 years ago
Lots of updates from the last week for conditional compiles and other stuff.
Property svn:eol-style set to `CRLF` Property svn:keywords set to `Author Date Id Revision`
File size: 37.3 KB

Line
1
2	/*
3	*@@sourcefile winh.h:
4	* header file for winh.c (PM helper funcs). See remarks there.
5	*
6	* Special #define's which this thing reacts to:
7	*
8	* -- If WINH_STANDARDWRAPPERS is defined to anything, this include
9	* file maps a number of freqently API calls (such as WinSendMsg)
10	* to winh* equivalents to reduce the amount of fixup records
11	* in the final executable.
12	*
13	* Note: Version numbering in this file relates to XWorkplace version
14	* numbering.
15	*/
16
17	/* Copyright (C) 1997-2000 Ulrich Mller.
18	* This file is part of the "XWorkplace helpers" source package.
19	* This is free software; you can redistribute it and/or modify
20	* it under the terms of the GNU General Public License as published
21	* by the Free Software Foundation, in version 2 as it comes in the
22	* "COPYING" file of the XWorkplace main distribution.
23	* This program is distributed in the hope that it will be useful,
24	* but WITHOUT ANY WARRANTY; without even the implied warranty of
25	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26	* GNU General Public License for more details.
27	*
28	*@@include #define INCL_WINWINDOWMGR
29	*@@include #define INCL_WINMESSAGEMGR
30	*@@include #define INCL_WINSYS // for winhStorePresParam
31	*@@include #define INCL_WINDIALOGS
32	*@@include #define INCL_WINMENUS // for menu helpers
33	*@@include #define INCL_WINENTRYFIELDS // for entry field helpers
34	*@@include #define INCL_WINBUTTONS // for button/check box helpers
35	*@@include #define INCL_WINLISTBOXES // for list box helpers
36	*@@include #define INCL_WINSTDSPIN // for spin button helpers
37	*@@include #define INCL_WINSTDSLIDER // for slider helpers
38	*@@include #define INCL_WININPUT
39	*@@include #define INCL_WINSYS
40	*@@include #define INCL_WINSHELLDATA
41	*@@include #define INCL_WINSWITCHLIST // for winhQuerySwitchList
42	*@@include #define INCL_WINPROGRAMLIST // for appStartApp
43	*@@include #define INCL_WINHELP // for help manager helpers
44	*@@include #include <os2.h>
45	*@@include #include "winh.h"
46	*/
47
48	#if __cplusplus
49	extern "C" {
50	#endif
51
52	#ifndef WINH_HEADER_INCLUDED
53	#define WINH_HEADER_INCLUDED
54
55	#ifndef XWPENTRY
56	#error You must define XWPENTRY to contain the standard linkage for the XWPHelpers.
57	#endif
58
59	/* ******************************************************************
60	*
61	* Declarations
62	*
63	********************************************************************/
64
65	#define MPNULL (MPFROMP(NULL))
66	#define MPZERO (MPFROMSHORT(0))
67	#define MRTRUE (MRFROMSHORT((SHORT) TRUE))
68	#define MRFALSE (MRFROMSHORT((SHORT) FALSE))
69	#define BM_UNCHECKED 0 // for checkboxes: disabled
70	#define BM_CHECKED 1 // for checkboses: enabled
71	#define BM_INDETERMINATE 2 // for tri-state checkboxes: indeterminate
72
73	/* ******************************************************************
74	*
75	* Wrappers
76	*
77	********************************************************************/
78
79	// if WINH_STANDARDWRAPPERS is #define'd before including winh.h,
80	// all the following Win* API calls are redirected to the winh*
81	// counterparts
82
83	#ifdef WINH_STANDARDWRAPPERS
84
85	MRESULT XWPENTRY winhSendMsg(HWND hwnd, ULONG msg, MPARAM mp1, MPARAM mp2);
86	#define WinSendMsg(a,b,c,d) winhSendMsg((a),(b),(c),(d))
87
88	MRESULT XWPENTRY winhSendDlgItemMsg(HWND hwnd, ULONG id, ULONG msg, MPARAM mp1, MPARAM mp2);
89	#define WinSendDlgItemMsg(a,b,c,d,e) winhSendDlgItemMsg((a),(b),(c),(d),(e))
90
91	BOOL XWPENTRY winhPostMsg(HWND hwnd, ULONG msg, MPARAM mp1, MPARAM mp2);
92	#define WinPostMsg(a,b,c,d) winhPostMsg((a),(b),(c),(d))
93
94	HWND XWPENTRY winhWindowFromID(HWND hwnd, ULONG id);
95	#define WinWindowFromID(a,b) winhWindowFromID((a),(b))
96
97	HWND XWPENTRY winhQueryWindow(HWND hwnd, LONG lCode);
98	#define WinQueryWindow(a,b) winhQueryWindow((a),(b))
99
100	PVOID XWPENTRY winhQueryWindowPtr(HWND hwnd, LONG index);
101	#define WinQueryWindowPtr(a,b) winhQueryWindowPtr((a),(b))
102
103	BOOL XWPENTRY winhSetWindowText2(HWND hwnd, const char *pcsz);
104	#define WinSetWindowText(a,b) winhSetWindowText2((a),(b))
105
106	BOOL XWPENTRY winhSetDlgItemText(HWND hwnd, ULONG id, const char *pcsz);
107	#define WinSetDlgItemText(a,b,c) winhSetDlgItemText((a),(b),(c))
108	#endif
109
110	/* ******************************************************************
111	*
112	* Macros
113	*
114	********************************************************************/
115
116	/*
117	* Here come some monster macros for
118	* frequently needed functions.
119	*/
120
121	#define winhDebugBox(hwndOwner, title, text) \
122	WinMessageBox(HWND_DESKTOP, hwndOwner, ((PSZ)text), ((PSZ)title), 0, MB_OK \| MB_ICONEXCLAMATION \| MB_MOVEABLE)
123
124	#define winhYesNoBox(title, text) \
125	WinMessageBox(HWND_DESKTOP, HWND_DESKTOP, ((PSZ)text), ((PSZ)title), 0, MB_YESNO \| MB_ICONQUESTION \| MB_MOVEABLE)
126
127	#define winhSetDlgItemChecked(hwnd, id, bCheck) \
128	WinSendDlgItemMsg((hwnd), (id), BM_SETCHECK, MPFROMSHORT(bCheck), MPNULL)
129	#define winhIsDlgItemChecked(hwnd, id) \
130	(SHORT1FROMMR(WinSendDlgItemMsg((hwnd), (id), BM_QUERYCHECK, MPNULL, MPNULL)))
131
132	#define winhSetMenuItemChecked(hwndMenu, usId, bCheck) \
133	WinSendMsg(hwndMenu, MM_SETITEMATTR, MPFROM2SHORT(usId, TRUE), \
134	MPFROM2SHORT(MIA_CHECKED, (((bCheck)) ? MIA_CHECKED : FALSE)))
135
136	#define winhShowDlgItem(hwnd, id, show) \
137	WinShowWindow(WinWindowFromID(hwnd, id), show)
138
139	// made these functions V0.9.12 (2001-05-18) [umoeller]
140	/* #define winhEnableDlgItem(hwndDlg, ulId, Enable) \
141	WinEnableWindow(WinWindowFromID(hwndDlg, ulId), Enable)
142	#define winhIsDlgItemEnabled(hwndDlg, ulId) \
143	WinIsWindowEnabled(WinWindowFromID(hwndDlg, ulId))
144	*/
145
146	#define winhSetDlgItemFocus(hwndDlg, ulId) \
147	WinSetFocus(HWND_DESKTOP, WinWindowFromID(hwndDlg, ulId))
148
149	/* ******************************************************************
150	*
151	* Rectangle helpers
152	*
153	********************************************************************/
154
155	VOID XWPENTRY winhOffsetRect(PRECTL prcl, LONG lx, LONG ly);
156
157	/* ******************************************************************
158	*
159	* Generics
160	*
161	********************************************************************/
162
163	ULONG XWPENTRY winhQueryWindowStyle(HWND hwnd);
164
165	BOOL XWPENTRY winhEnableDlgItem(HWND hwndDlg, SHORT id, BOOL fEnable);
166
167	BOOL XWPENTRY winhIsDlgItemEnabled(HWND hwndDlg, SHORT id);
168
169	/* ******************************************************************
170	*
171	* Menu helpers
172	*
173	********************************************************************/
174
175	#ifdef INCL_WINMENUS
176	BOOL XWPENTRY winhQueryMenuItem(HWND hwndMenu,
177	USHORT usItemID,
178	BOOL fSearchSubmenus,
179	PMENUITEM pmi);
180	#endif
181
182	/*
183	* winhCreateEmptyMenu:
184	* this macro creates an empty menu, which can
185	* be used with winhInsertMenuItem etc. later.
186	* Useful for creating popup menus on the fly.
187	* Note that even though HWND_DESKTOP is specified
188	* here as both the parent and the owner, the
189	* actual owner and parent are specified later
190	* with WinPopupMenu.
191	*/
192
193	#define winhCreateEmptyMenu() \
194	WinCreateWindow(HWND_DESKTOP, WC_MENU, "", 0, 0, 0, 0, 0, \
195	HWND_DESKTOP, HWND_TOP, 0, 0, 0)
196
197	SHORT XWPENTRY winhInsertMenuItem(HWND hwndMenu,
198	SHORT iPosition,
199	SHORT sItemId,
200	const char *pcszItemTitle,
201	SHORT afStyle,
202	SHORT afAttr);
203	typedef SHORT XWPENTRY WINHINSERTMENUITEM(HWND hwndMenu,
204	SHORT iPosition,
205	SHORT sItemId,
206	const char *pcszItemTitle,
207	SHORT afStyle,
208	SHORT afAttr);
209	typedef WINHINSERTMENUITEM *PWINHINSERTMENUITEM;
210
211	HWND XWPENTRY winhInsertSubmenu(HWND hwndMenu,
212	ULONG iPosition,
213	SHORT sMenuId,
214	const char *pcszSubmenuTitle,
215	USHORT afMenuStyle,
216	SHORT sItemId,
217	const char *pcszItemTitle,
218	USHORT afItemStyle,
219	USHORT afAttribute);
220	typedef HWND XWPENTRY WINHINSERTSUBMENU(HWND hwndMenu,
221	ULONG iPosition,
222	SHORT sMenuId,
223	const char *pcszSubmenuTitle,
224	USHORT afMenuStyle,
225	SHORT sItemId,
226	const char *pcszItemTitle,
227	USHORT afItemStyle,
228	USHORT afAttribute);
229	typedef WINHINSERTSUBMENU *PWINHINSERTSUBMENU;
230
231	BOOL XWPENTRY winhSetMenuCondCascade(HWND hwndMenu,
232	LONG lDefaultItem);
233
234	/*
235	*@@ winhRemoveMenuItem:
236	* removes a menu item (SHORT) from the
237	* given menu (HWND). Returns the no. of
238	* remaining menu items (SHORT).
239	*
240	* This works for whole submenus too.
241	*/
242
243	#define winhRemoveMenuItem(hwndMenu, sItemId) \
244	(SHORT)WinSendMsg(hwndMenu, MM_REMOVEITEM, MPFROM2SHORT(sItemId, FALSE), 0)
245
246	/*
247	*@@ winhDeleteMenuItem:
248	* deleted a menu item (SHORT) from the
249	* given menu (HWND). Returns the no. of
250	* remaining menu items (SHORT).
251	*
252	* As opposed to MM_REMOVEITEM, MM_DELETEITEM
253	* frees submenus and bitmaps also.
254	*
255	* This works for whole submenus too.
256	*/
257
258	#define winhDeleteMenuItem(hwndMenu, sItemId) \
259	(SHORT)WinSendMsg(hwndMenu, MM_DELETEITEM, MPFROM2SHORT(sItemId, FALSE), 0)
260
261	SHORT XWPENTRY winhInsertMenuSeparator(HWND hMenu,
262	SHORT iPosition,
263	SHORT sId);
264
265	BOOL XWPENTRY winhCopyMenuItem(HWND hmenuTarget,
266	HWND hmenuSource,
267	USHORT usID,
268	SHORT sTargetPosition);
269	typedef BOOL XWPENTRY WINHCOPYMENUITEM(HWND hmenuTarget,
270	HWND hmenuSource,
271	USHORT usID,
272	SHORT sTargetPosition);
273	typedef WINHCOPYMENUITEM *PWINHCOPYMENUITEM;
274
275	HWND XWPENTRY winhMergeIntoSubMenu(HWND hmenuTarget,
276	SHORT sTargetPosition,
277	const char *pcszTitle,
278	SHORT sID,
279	HWND hmenuSource);
280	typedef HWND XWPENTRY WINHMERGEINTOSUBMENU(HWND hmenuTarget,
281	SHORT sTargetPosition,
282	const char *pcszTitle,
283	SHORT sID,
284	HWND hmenuSource);
285	typedef WINHMERGEINTOSUBMENU *PWINHMERGEINTOSUBMENU;
286
287	PSZ XWPENTRY winhQueryMenuItemText(HWND hwndMenu,
288	USHORT usItemID);
289
290	BOOL XWPENTRY winhAppend2MenuItemText(HWND hwndMenu,
291	USHORT usItemID,
292	const char *pcszAppend,
293	BOOL fTab);
294
295	VOID XWPENTRY winhMenuRemoveEllipse(HWND hwndMenu,
296	USHORT usItemId);
297
298	SHORT XWPENTRY winhQueryItemUnderMouse(HWND hwndMenu, POINTL pptlMouse, RECTL prtlItem);
299
300	/* ******************************************************************
301	*
302	* Slider helpers
303	*
304	********************************************************************/
305
306	HWND XWPENTRY winhReplaceWithLinearSlider(HWND hwndParent,
307	HWND hwndOwner,
308	HWND hwndInsertAfter,
309	ULONG ulID,
310	ULONG ulSliderStyle,
311	ULONG ulTickCount);
312
313	BOOL XWPENTRY winhSetSliderTicks(HWND hwndSlider,
314	MPARAM mpEveryOther1,
315	ULONG ulPixels1,
316	MPARAM mpEveryOther2,
317	ULONG ulPixels2);
318	typedef BOOL XWPENTRY WINHSETSLIDERTICKS(HWND hwndSlider,
319	MPARAM mpEveryOther1,
320	ULONG ulPixels1,
321	MPARAM mpEveryOther2,
322	ULONG ulPixels2);
323	typedef WINHSETSLIDERTICKS *PWINHSETSLIDERTICKS;
324
325	/*
326	* winhSetSliderArmPosition:
327	* this moves the slider arm in a given
328	* linear slider.
329	*
330	* usMode can be one of the following:
331	* -- SMA_RANGEVALUE: usOffset is in pixels
332	* from the slider's home position.
333	* -- SMA_INCREMENTVALUE: usOffset is in
334	* units of the slider's primary scale.
335	*/
336
337	#define winhSetSliderArmPosition(hwndSlider, usMode, usOffset) \
338	WinSendMsg(hwndSlider, SLM_SETSLIDERINFO, \
339	MPFROM2SHORT(SMA_SLIDERARMPOSITION, \
340	usMode), \
341	MPFROMSHORT(usOffset))
342
343	/*
344	* winhQuerySliderArmPosition:
345	* reverse to the previous, this returns a
346	* slider arm position (as a LONG value).
347	*/
348
349	#define winhQuerySliderArmPosition(hwndSlider, usMode) \
350	(LONG)(WinSendMsg(hwndSlider, \
351	SLM_QUERYSLIDERINFO, \
352	MPFROM2SHORT(SMA_SLIDERARMPOSITION, \
353	usMode), \
354	0))
355
356	HWND XWPENTRY winhReplaceWithCircularSlider(HWND hwndParent,
357	HWND hwndOwner,
358	HWND hwndInsertAfter,
359	ULONG ulID,
360	ULONG ulSliderStyle,
361	SHORT sMin,
362	SHORT sMax,
363	USHORT usIncrement,
364	USHORT usTicksEvery);
365
366	/* ******************************************************************
367	*
368	* Spin button helpers
369	*
370	********************************************************************/
371
372	VOID XWPENTRY winhSetDlgItemSpinData(HWND hwndDlg,
373	ULONG idSpinButton,
374	ULONG min,
375	ULONG max,
376	ULONG current);
377	typedef VOID XWPENTRY WINHSETDLGITEMSPINDATA(HWND hwndDlg,
378	ULONG idSpinButton,
379	ULONG min,
380	ULONG max,
381	ULONG current);
382	typedef WINHSETDLGITEMSPINDATA *PWINHSETDLGITEMSPINDATA;
383
384	LONG XWPENTRY winhAdjustDlgItemSpinData(HWND hwndDlg,
385	USHORT usItemID,
386	LONG lGrid,
387	USHORT usNotifyCode);
388	typedef LONG XWPENTRY WINHADJUSTDLGITEMSPINDATA(HWND hwndDlg,
389	USHORT usItemID,
390	LONG lGrid,
391	USHORT usNotifyCode);
392	typedef WINHADJUSTDLGITEMSPINDATA *PWINHADJUSTDLGITEMSPINDATA;
393
394	/* ******************************************************************
395	*
396	* Entry field helpers
397	*
398	********************************************************************/
399
400	/*
401	* winhSetEntryFieldLimit:
402	* sets the maximum length for the entry field
403	* (EM_SETTEXTLIMIT message).
404	*
405	* PMREF doesn't say this, but the limit does
406	* _not_ include the null-terminator. That is,
407	* if you specify "12" characters here, you can
408	* really enter 12 characters.
409	*
410	* The default length is 30 characters, I think.
411	*/
412
413	#define winhSetEntryFieldLimit(hwndEntryField, usLength) \
414	WinSendMsg(hwndEntryField, EM_SETTEXTLIMIT, (MPARAM)(usLength), (MPARAM)0)
415
416	/*
417	*@@ winhEntryFieldSelectAll:
418	* this selects the entire text in the entry field.
419	* Useful when the thing gets the focus.
420	*/
421
422	#define winhEntryFieldSelectAll(hwndEntryField) \
423	WinSendMsg(hwndEntryField, EM_SETSEL, MPFROM2SHORT(0, 10000), MPNULL)
424
425	/*
426	*@@ winhHasEntryFieldChanged:
427	* this queries whether the entry field's contents
428	* have changed (EM_QUERYCHANGED message).
429	*
430	* This returns TRUE if changes have occured since
431	* the last time this message or WM_QUERYWINDOWPARAMS
432	* (WinQueryWindowText) was received.
433	*/
434
435	#define winhHasEntryFieldChanged(hwndEntryField) \
436	(BOOL)WinSendMsg(hwndEntryField, EM_QUERYCHANGED, (MPARAM)0, (MPARAM)0)
437
438	/* ******************************************************************
439	*
440	* List box helpers
441	*
442	********************************************************************/
443
444	/* The following macros are defined in the OS/2 headers for
445	list boxes:
446
447	LONG WinQueryLboxCount(HWND hwndLbox);
448	// wrapper around LM_QUERYITEMCOUNT;
449	// list box item count
450
451	SHORT WinQueryLboxItemTextLength(HWND hwndLbox,
452	SHORT index); // item index, starting from 0
453	// wrapper around LM_QUERYITEMTEXTLENGTH;
454	// returns length of item text, excluding NULL character
455
456	LONG WinQueryLboxItemText(HWND hwndLbox,
457	SHORT index, // item index, starting from 0
458	PSZ psz, // buffer
459	PSZ cchMax); // size of buffer, incl. null
460	// wrapper around LM_QUERYITEMTEXT;
461	// returns length of item text, excluding NULL character
462
463	BOOL WinSetLboxItemText(HWND hwndLbox,
464	LONG index,
465	PSZ psz);
466	// wrapper around LM_SETITEMTEXT
467
468	LONG WinInsertLboxItem(HWND hwndLbox,
469	LONG index, // new item index, starting from 0
470	// or LIT_END
471	// or LIT_SORTASCENDING
472	// or LIT_SORTDESCENDING
473	PSZ psz)
474	// wrapper around LM_INSERTITEM;
475	// returns LIT_MEMERROR, LIT_ERROR, or zero-based index
476
477	LONG WinDeleteLboxItem(HWND hwndLbox,
478	LONG index); // item index, starting from 0
479
480	LONG WinQueryLboxSelectedItem(HWND hwndLbox);
481	// wrapper around LM_QUERYSELECTION;
482	// works with single selection only,
483	// use winhQueryLboxSelectedItem instead
484	*/
485
486	/*
487	* winhQueryLboxItemCount:
488	* returns the no. of items in the listbox
489	* as a SHORT.
490	*
491	*added V0.9.1 (99-12-14) [umoeller]
492	*/
493
494	// #define winhQueryLboxItemCount(hwndListBox)
495	// (SHORT)WinSendMsg(hwndListBox, LM_QUERYITEMCOUNT, 0, 0)
496
497	// removed, use WinQueryLboxCount
498
499	/*
500	*@@ winhDeleteAllItems:
501	* deletes all list box items. Returns
502	* a BOOL.
503	*
504	*@@added V0.9.1 (99-12-14) [umoeller]
505	*/
506
507	#define winhDeleteAllItems(hwndListBox) \
508	(BOOL)WinSendMsg(hwndListBox, \
509	LM_DELETEALL, 0, 0)
510	/*
511	*@@ winhQueryLboxSelectedItem:
512	* this queries the next selected list box item.
513	* For the first call, set sItemStart to LIT_FIRST;
514	* then repeat the call with sItemStart set to
515	* the previous return value until this returns
516	* LIT_NONE.
517	*
518	* Example:
519	+ SHORT sItemStart = LIT_FIRST;
520	+ while (TRUE)
521	+ {
522	+ sItemStart = winhQueryLboxSelectedItem(hwndListBox,
523	+ sItemStart)
524	+ if (sItemStart == LIT_NONE)
525	+ break;
526	+ ...
527	+ }
528	*
529	* To have the cursored item returned, use LIT_CURSOR.
530	*
531	* For single selection, you can also use
532	* WinQueryLboxSelectedItem from the OS/2 PM headers.
533	*/
534
535	#define winhQueryLboxSelectedItem(hwndListBox, sItemStart) \
536	(SHORT)(WinSendMsg(hwndListBox, \
537	LM_QUERYSELECTION, \
538	(MPARAM)(sItemStart), \
539	MPNULL))
540
541	/*
542	*@@ winhSetLboxSelectedItem:
543	* selects a list box item.
544	* This works for both single-selection and
545	* multiple-selection listboxes.
546	* In single-selection listboxes, if an item
547	* is selected (fSelect == TRUE), the previous
548	* item is automatically deselected.
549	* Note that (BOOL)fSelect is ignored if
550	* sItemIndex == LIT_NONE.
551	*/
552
553	#define winhSetLboxSelectedItem(hwndListBox, sItemIndex, fSelect) \
554	(BOOL)(WinSendMsg(hwndListBox, \
555	LM_SELECTITEM, \
556	(MPARAM)(sItemIndex), \
557	(MPARAM)(fSelect)))
558
559	ULONG XWPENTRY winhLboxSelectAll(HWND hwndListBox, BOOL fSelect);
560
561	/*
562	* winhSetLboxItemHandle:
563	* sets the "item handle" for the specified sItemIndex.
564	* See LM_SETITEMHANDLE in PMREF for details.
565	*/
566
567	#define winhSetLboxItemHandle(hwndListBox, sItemIndex, ulHandle) \
568	(BOOL)(WinSendMsg(hwndListBox, LM_SETITEMHANDLE, \
569	(MPARAM)(sItemIndex), \
570	(MPARAM)ulHandle))
571
572	/*
573	* winhQueryLboxItemHandle:
574	* the reverse to the previous. Returns a ULONG.
575	*/
576
577	#define winhQueryLboxItemHandle(hwndListBox, sItemIndex) \
578	(ULONG)WinSendMsg(hwndListBox, LM_QUERYITEMHANDLE, \
579	MPFROMSHORT(sItemIndex), (MPARAM)NULL)
580
581	PSZ XWPENTRY winhQueryLboxItemText(HWND hwndListbox, SHORT sIndex);
582
583	BOOL XWPENTRY winhMoveLboxItem(HWND hwndSource,
584	SHORT sSourceIndex,
585	HWND hwndTarget,
586	SHORT sTargetIndex,
587	BOOL fSelectTarget);
588
589	ULONG XWPENTRY winhLboxFindItemFromHandle(HWND hwndListBox,
590	ULONG ulHandle);
591
592	/* ******************************************************************
593	*
594	* Scroll bar helpers
595	*
596	********************************************************************/
597
598	BOOL XWPENTRY winhUpdateScrollBar(HWND hwndScrollBar,
599	ULONG ulWinPels,
600	ULONG ulViewportPels,
601	ULONG ulCurUnitOfs,
602	BOOL fAutoHide);
603
604	BOOL XWPENTRY winhHandleScrollMsg(HWND hwnd2Scroll,
605	HWND hwndScrollBar,
606	PULONG pulCurPelsOfs,
607	PRECTL prcl2Scroll,
608	LONG ulViewportPels,
609	USHORT usLineStepUnits,
610	ULONG msg,
611	MPARAM mp2);
612
613	BOOL XWPENTRY winhProcessScrollChars(HWND hwndClient,
614	HWND hwndVScroll,
615	HWND hwndHScroll,
616	MPARAM mp1,
617	MPARAM mp2,
618	ULONG ulVertMax,
619	ULONG ulHorzMax);
620
621	/* ******************************************************************
622	*
623	* Window positioning helpers
624	*
625	********************************************************************/
626
627	BOOL XWPENTRY winhSaveWindowPos(HWND hwnd, HINI hIni, const char pcszApp, const char pcszKey);
628
629	BOOL XWPENTRY winhRestoreWindowPos(HWND hwnd, HINI hIni, const char pcszApp, const char pcszKey, ULONG fl);
630
631	#define XAC_MOVEX 0x0001
632	#define XAC_MOVEY 0x0002
633	#define XAC_SIZEX 0x0004
634	#define XAC_SIZEY 0x0008
635
636	/*
637	*@@ XADJUSTCTRLS:
638	*
639	*/
640
641	typedef struct _XADJUSTCTRLS
642	{
643	BOOL fInitialized;
644	SWP swpMain; // SWP for main window
645	SWP *paswp; // pointer to array of control SWP structs
646	} XADJUSTCTRLS, *PXADJUSTCTRLS;
647
648	BOOL XWPENTRY winhAdjustControls(HWND hwndDlg,
649	MPARAM *pmpFlags,
650	ULONG ulCount,
651	PSWP pswpNew,
652	PXADJUSTCTRLS pxac);
653
654	void XWPENTRY winhCenterWindow(HWND hwnd);
655	typedef void XWPENTRY WINHCENTERWINDOW(HWND hwnd);
656	typedef WINHCENTERWINDOW *PWINHCENTERWINDOW;
657
658	HWND XWPENTRY winhFindWindowBelow(HWND hwndFind);
659
660	/* ******************************************************************
661	*
662	* Presparams helpers
663	*
664	********************************************************************/
665
666	PSZ XWPENTRY winhQueryWindowFont(HWND hwnd);
667	typedef PSZ XWPENTRY WINHQUERYWINDOWFONT(HWND hwnd);
668	typedef WINHQUERYWINDOWFONT *PWINHQUERYWINDOWFONT;
669
670	BOOL XWPENTRY winhSetWindowFont(HWND hwnd, const char *pcszFont);
671	typedef BOOL XWPENTRY WINHSETWINDOWFONT(HWND hwnd, const char *pcszFont);
672	typedef WINHSETWINDOWFONT *PWINHSETWINDOWFONT;
673
674	/*
675	*@@ winhSetDlgItemFont:
676	* invokes winhSetWindowFont on a dialog
677	* item.
678	*
679	* Returns TRUE if successful or FALSE otherwise.
680	*
681	*@@added V0.9.0
682	*/
683
684	#define winhSetDlgItemFont(hwnd, usId, pszFont) \
685	(winhSetWindowFont(WinWindowFromID(hwnd, usId), pszFont))
686
687	ULONG XWPENTRY winhSetControlsFont(HWND hwndDlg, SHORT usIDMin, SHORT usIDMax, const char *pcszFont);
688
689	#ifdef INCL_WINSYS
690	BOOL XWPENTRY winhStorePresParam(PPRESPARAMS *pppp,
691	ULONG ulAttrType,
692	ULONG cbData,
693	PVOID pData);
694	#endif
695
696	LONG XWPENTRY winhQueryPresColor(HWND hwnd, ULONG ulPP, BOOL fInherit, LONG lSysColor);
697	typedef LONG XWPENTRY WINHQUERYPRESCOLOR(HWND hwnd, ULONG ulPP, BOOL fInherit, LONG lSysColor);
698	typedef WINHQUERYPRESCOLOR *PWINHQUERYPRESCOLOR;
699
700	/* ******************************************************************
701	*
702	* Help instance helpers
703	*
704	********************************************************************/
705
706	#ifdef INCL_WINHELP
707	HWND XWPENTRY winhCreateHelp(HWND hwndFrame,
708	const char *pcszFileName,
709	HMODULE hmod,
710	PHELPTABLE pHelpTable,
711	const char *pcszWindowTitle);
712
713	ULONG winhDisplayHelpPanel(HWND hwndHelpInstance,
714	ULONG ulHelpPanel);
715
716	void XWPENTRY winhDestroyHelp(HWND hwndHelp, HWND hwndFrame);
717	#endif
718
719	/* ******************************************************************
720	*
721	* Application control
722	*
723	********************************************************************/
724
725	BOOL XWPENTRY winhAnotherInstance(const char *pcszSemName, BOOL fSwitch);
726
727	HSWITCH XWPENTRY winhAddToTasklist(HWND hwnd, HPOINTER hIcon);
728
729	/* ******************************************************************
730	*
731	* Miscellaneous
732	*
733	********************************************************************/
734
735	VOID XWPENTRY winhFree(PVOID p);
736	typedef VOID XWPENTRY WINHFREE(PVOID p);
737	typedef WINHFREE *PWINHFREE;
738
739	HAB XWPENTRY winhMyAnchorBlock(VOID);
740	typedef HAB XWPENTRY WINHMYANCHORBLOCK(VOID);
741	typedef WINHMYANCHORBLOCK *PWINHMYANCHORBLOCK;
742
743	VOID XWPENTRY winhSleep(ULONG ulSleep);
744
745	#define WINH_FOD_SAVEDLG 0x0001
746	#define WINH_FOD_INILOADDIR 0x0010
747	#define WINH_FOD_INISAVEDIR 0x0020
748
749	BOOL XWPENTRY winhFileDlg(HWND hwndOwner,
750	PSZ pszFile,
751	ULONG flFlags,
752	HINI hini,
753	const char *pcszApplication,
754	const char *pcszKey);
755
756	HPOINTER XWPENTRY winhSetWaitPointer(VOID);
757
758	PSZ XWPENTRY winhQueryWindowText(HWND hwnd);
759
760	BOOL XWPENTRY winhSetWindowText(HWND hwnd,
761	const char *pcszFormat,
762	...);
763
764	/*
765	*@@ winhQueryDlgItemText:
766	* like winhQueryWindowText, but for the dialog item
767	* in hwnd which has the ID usItemID.
768	*/
769
770	#define winhQueryDlgItemText(hwnd, usItemID) winhQueryWindowText(WinWindowFromID(hwnd, usItemID))
771
772	BOOL XWPENTRY winhReplaceWindowText(HWND hwnd,
773	const char *pcszSearch,
774	const char *pcszReplaceWith);
775
776	ULONG XWPENTRY winhCenteredDlgBox(HWND hwndParent, HWND hwndOwner,
777	PFNWP pfnDlgProc, HMODULE hmod, ULONG idDlg, PVOID pCreateParams);
778	typedef ULONG XWPENTRY WINHCENTEREDDLGBOX(HWND hwndParent, HWND hwndOwner,
779	PFNWP pfnDlgProc, HMODULE hmod, ULONG idDlg, PVOID pCreateParams);
780	typedef WINHCENTEREDDLGBOX *PWINHCENTEREDDLGBOX;
781
782	ULONG XWPENTRY winhEnableControls(HWND hwndDlg,
783	USHORT usIDFirst,
784	USHORT usIDLast,
785	BOOL fEnable);
786
787	HWND XWPENTRY winhCreateStdWindow(HWND hwndFrameParent,
788	PSWP pswpFrame,
789	ULONG flFrameCreateFlags,
790	ULONG ulFrameStyle,
791	const char *pcszFrameTitle,
792	ULONG ulResourcesID,
793	const char *pcszClassClient,
794	ULONG flStyleClient,
795	ULONG ulID,
796	PVOID pClientCtlData,
797	PHWND phwndClient);
798
799	HWND XWPENTRY winhCreateObjectWindow(const char *pcszWindowClass,
800	PVOID pvCreateParam);
801
802	HWND XWPENTRY winhCreateControl(HWND hwndParentAndOwner,
803	const char *pcszClass,
804	const char *pcszText,
805	ULONG ulStyle,
806	ULONG ulID);
807
808	VOID XWPENTRY winhRepaintWindows(HWND hwndParent);
809
810	HMQ XWPENTRY winhFindMsgQueue(PID pid, TID tid, HAB* phab);
811
812	VOID XWPENTRY winhFindPMErrorWindows(HWND phwndHardError, HWND phwndSysError);
813
814	HWND XWPENTRY winhCreateFakeDesktop(HWND hwndSibling);
815
816	BOOL XWPENTRY winhAssertWarp4Notebook(HWND hwndDlg,
817	USHORT usIdThreshold,
818	ULONG ulDownUnits);
819
820	ULONG XWPENTRY winhDrawFormattedText(HPS hps, PRECTL prcl, const char *pcszText, ULONG flCmd);
821
822	#ifdef INCL_WINSWITCHLIST
823	PSWBLOCK XWPENTRY winhQuerySwitchList(HAB hab);
824	typedef PSWBLOCK XWPENTRY WINHQUERYSWITCHLIST(HAB hab);
825	typedef WINHQUERYSWITCHLIST *PWINHQUERYSWITCHLIST;
826	#endif
827
828	HWND XWPENTRY winhQueryTasklistWindow(VOID);
829	typedef HWND XWPENTRY WINHQUERYTASKLISTWINDOW(VOID);
830	typedef WINHQUERYTASKLISTWINDOW *PWINHQUERYTASKLISTWINDOW;
831
832	VOID XWPENTRY winhKillTasklist(VOID);
833
834	ULONG XWPENTRY winhQueryPendingSpoolJobs(VOID);
835
836	VOID XWPENTRY winhSetNumLock(BOOL fState);
837
838	/*
839	*@@ winhQueryScreenCX:
840	* helper macro for getting the screen width.
841	*/
842
843	#define winhQueryScreenCX() (WinQuerySysValue(HWND_DESKTOP, SV_CXSCREEN))
844
845	/*
846	*@@ winhQueryScreenCY:
847	* helper macro for getting the screen height.
848	*/
849
850	#define winhQueryScreenCY() (WinQuerySysValue(HWND_DESKTOP, SV_CYSCREEN))
851
852	/* ******************************************************************
853	*
854	* Extended frame
855	*
856	********************************************************************/
857
858	#define XFCF_STATUSBAR 0x0001
859
860	#define FID_STATUSBAR 0x8100
861
862	/*
863	*@@ EXTFRAMECDATA:
864	*
865	*@@added V0.9.16 (2001-09-29) [umoeller]
866	*/
867
868	typedef struct _EXTFRAMECDATA
869	{
870	PSWP pswpFrame; // in: frame wnd pos
871	ULONG flFrameCreateFlags; // in: FCF_* flags
872	ULONG flExtFlags; // in: XFCF_* flags
873	ULONG ulFrameStyle; // in: WS_* flags (e.g. WS_VISIBLE, WS_ANIMATE)
874	const char *pcszFrameTitle; // in: frame title (title bar)
875	ULONG ulResourcesID; // in: according to FCF_* flags
876	const char *pcszClassClient; // in: client class name
877	ULONG flStyleClient; // in: client style
878	ULONG ulID; // in: frame window ID
879	PVOID pClientCtlData; // in: pCtlData structure pointer for client
880	} EXTFRAMECDATA, *PEXTFRAMECDATA;
881
882	/*
883	*@@ EXTFRAMEDATA:
884	*
885	*@@added V0.9.16 (2001-09-29) [umoeller]
886	*/
887
888	typedef struct _EXTFRAMEDATA
889	{
890	EXTFRAMECDATA CData;
891
892	PFNWP pfnwpOrig; // original frame wnd proc from subclassing
893
894	PVOID pvUser; // more data for user (e.g. for additional subclassing)
895
896	} EXTFRAMEDATA, *PEXTFRAMEDATA;
897
898	HWND winhCreateStatusBar(HWND hwndFrame,
899	HWND hwndOwner,
900	const char *pcszText,
901	const char *pcszFont,
902	LONG lColor);
903
904	HWND winhCreateExtStdWindow(PEXTFRAMECDATA pData,
905	PHWND phwndClient);
906
907	/* ******************************************************************
908	*
909	* WPS Class List helpers
910	*
911	********************************************************************/
912
913	PBYTE XWPENTRY winhQueryWPSClassList(VOID);
914
915	PBYTE XWPENTRY winhQueryWPSClass(PBYTE pObjClass, const char *pszClass);
916
917	APIRET XWPENTRY winhRegisterClass(const char* pcszClassName,
918	const char* pcszModule,
919	PSZ pszBuf,
920	ULONG cbBuf);
921
922	BOOL XWPENTRY winhIsClassRegistered(const char *pcszClass);
923
924	ULONG XWPENTRY winhResetWPS(HAB hab);
925
926	#endif
927
928	#if __cplusplus
929	}
930	#endif
931

Note: See TracBrowser for help on using the repository browser.

Download in other formats: