Difference between revisions of "IsWindowTopMost"

From SCAR Divi Manual
Jump to: navigation, search
(Created page with "==Definition== <source lang="scar" lines="false"> function IsWindowTopMost(const Wnd: Hwnd): Boolean; </source> ==Availability== SCAR Divi 3.35 > Current ==Description== Ret...")
 
(Description)
 
Line 8: Line 8:
  
 
==Description==
 
==Description==
Returns true if the window specified by it's handle in '''Wnd''' exists and is in a topmost (, not foreground) position on the desktop.
+
Returns true if the window specified by it's handle in '''Wnd''' exists and is in a topmost position on the desktop. The topmost position means that the window can't be covered by most other windows, this is not the active window or foreground window.
  
 
==Example==
 
==Example==

Latest revision as of 12:22, 7 August 2012

Definition

function IsWindowTopMost(const Wnd: Hwnd): Boolean;

Availability

SCAR Divi 3.35 > Current

Description

Returns true if the window specified by it's handle in Wnd exists and is in a topmost position on the desktop. The topmost position means that the window can't be covered by most other windows, this is not the active window or foreground window.

Example

var
  Wnds: THwndArray;
 
begin
  Wnds := FindWindowsEx(GetDesktopWindow, 'notepad', '', False, False, True);  
  if Length(Wnds) > 0 then
  begin
    WriteLn(IsWindowTopMost(Wnds[0]));
    SetWindowTopMost(Wnds[0], True);
    WriteLn(IsWindowTopMost(Wnds[0]));
  end;
end.

See Also