SpIsWindow

This function determines if a window handle is valid.

Syntax: iswindow = spIsWindow ( hwnd )

Parameter: hwnd – Window handle.

Returns:

• True (1) – Window handle is valid.
• False (0) – Window handle is invalid.

Example Code:

/* wininfo.cmd (spUtils Example Code) */
/* waits for focus change and displays infos about the new focus window */
CALL RXFUNCADD 'spLoadFuncs','spUtils','spLoadFuncs'
CALL spLoadFuncs
CALL spSetAutoSleep 1000

hwnd=spQueryFocus()
SAY 'Change Focus to window control to be inspekted.'
do while hwnd=spQueryFocus()
     nop
end
SAY 'Focus change detected'
CALL spSetAutoSleep 50

hwnd=spQueryFocus()
CALL ShowInfo 'Focus window',hwnd
CALL ShowInfo 'Parent window',spQueryWindow(hwnd,'QW_PARENT')
CALL ShowInfo 'Owner window',spQueryWindow(hwnd,'QW_OWNER')
CALL ShowInfo 'Frame owner',spQueryWindow(hwnd,'QW_FRAMEOWNER')

RETURN

ShowInfo: PROCEDURE
   sp=LEFT(,20,' ')

   IF \spIsWindow(ARG(2)) THEN RETURN

   id=spQueryWindowID(ARG(2))
   IF spIsWindowEnabled(ARG(2)) THEN stat='enabled'; ELSE stat='disabled'
   IF spIsWindowShowing(ARG(2)) THEN showing='yes'; ELSE showing='no'
   IF spIsWindowVisible(ARG(2)) THEN visible='yes'; ELSE visible='no'

   SAY 
   SAY LEFT(ARG(1),20,' ')||,
           'text: "'||spQueryWindowText(ARG(2))||'"'
   SAY sp||'handle: '||ARG(2)||' (0x'||spD2X(ARG(2),'l')||')'
   SAY sp||'id: '||id||' (0x'||D2X(id)||')'
   SAY sp||'state: '||stat
   SAY sp||'showing: '||showing
   SAY sp||'visible: '||visible

   RETURN