MyAES specific developper documentation


Specific wind_set() wind_get() new options avaibility

Since MyAES 0.81 it is possible extend in a general way options in wind_set()
and wind_get() without need look in appl_getinfo() a bit field, now you can 
put for this functions an window handle = -2 if function return 0 this options
is not avaible else it is. All options are support. if an option need some 
particular suboptions then this function will answer about this in the same 
way, just put this suboption on parameter and function will return 0 or 1 for 
this.
Avaibility of this feature: For last time we add for this a bit in 
appl_getinfo(AES_WINDOW,&out1,...) should return in out1 the bit 15 to true. 
If not this feature is not support.

wind_set(handle, WF_TOPMOST,..) description is write by Odd Skanke thanks
-----------------------------------------------------------------------
 WF_TOPMOST

 A class of windows that will always 'float' ontop of classical windows.
One key feature of windows in any WF_TOPMOST state is that they do not
disturb current keyboard focus, and can be used to issue important
messages, status raports, etc., without demanding user interaction.

wind_set(handle,WF_TOPMOST, parm1,...)

#define WF_TOPMOST 232
parm1:
        0 : Remove topmost state on the corresponding window.
        1 : Set topmost state on the corresponding window.
        2 : Set topmost state and link window visibility to the
            owner's focus. That is, when owner is untopped the
            window disappears, when owner regains focus, the
            window automatically reappears.

How to use:

handle = wind_create()
wind_set(handle,WF_TOPMOST, 1, dummy, dummy,dummy);
wind_open(handle);

 Some common characteristics of windows with any WF_TOPMOST state set;

1) Changing the WF_TOPMOST state can be done on open windows, but it is 
prefer not if possible.
2) Windows which have TOPMOST state 1 or 2 never get keyboard focus.
3) Windows which have TOPMOST state 1 or 2 never get WM_TOPPED or
   WM_UNTOPPED AES messages.


WF_TOPMOST state 1:
  Setting state 1 will make the corresponding window 'float' ontop of
all other classical windows. State 1 windows will stay ontop until
closed by the user or the application itself.

WF_TOPMOST state 2:
  Setting state 1 will make the corresponding window act like windows
with state 1 set, with one important exception; The window is linked to
the window owner's focus status. This means that when the application
that owns the window looses focus, state 2 windows are automatically
made unvisible by the AES. When the application regains focus, the
window is automatically made visible again. This is done automatically,
and no application handling is necessary.
-----------------------------------------------------------------------

wind_get(handle, WF_TOPMOST,...)

return the WF8TOPMOST state as it is put by wind_set()

Avaibility of WF_TOPMOST feature using wind_set(-2,WF_TOPMOST,1,...) as describe
previously.

