View source for 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

[[Category:The OS/2 API Project]]