GoFiler Legato Script Reference   Legato v 1.5d Application v 5.25a

Table of Contents	< < Previous	Next >>

 

Chapter Fifteen — Windows/OS Functions (continued)

GetParentWindow Function

Overview

The GetParentWindow function returns the parent (owner) window handle for a provided window handle.

Syntax/Parameters

Syntax

handle = GetParentWindow ( handle hWindow );

Parameters

hWindow

A handle representing a window.

Return Value

Returns a handle of the parent window or NULL_HANDLE on error. Use the GetLastError function to retrieve a formatted error code. On error, the underlying error number will be a Windows API error code.

This function typically fails for one of the following reasons:

–  The provided hWindow parameter is invalid.

–  The window is a top-level window that is unowned or does not have the WS_POPUP style.

–  The owner window has WS_POPUP style.

Remarks

If the window is a child window, the return value is a handle to the parent window. If the window is a top-level window with the WS_POPUP style, the return value is a handle to the owner window.

Related Functions

GetApplicationFrameWindow — Returns the handle to the application’s Frame window, if available.

GetApplicationMDIWindow — Returns the handle to the application’s MDI Client window, if available.

GetDashboardWindow — Returns the handle to the application’s Dashboard window, if available.

GetDesktopWindow — Returns the handle to the desktop window.

GetInfoViewWindow — Returns the handle to the application’s Information View window, if available.

GetManagementViewWindow — Returns the handle to the application’s Management View window, if available.

GetProgressWindow — Returns the handle to the application’s Progress window, if available.

GetProjectMDIWindow — Returns the handle to the application’s Project MDI window, if available.

GetProjectTabWindow — Returns the handle to the application’s Project Tab window, if available.

IsWindowHandleValid — Tests a handle value as being a valid window handle.

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic

 

Table of Contents	< < Previous	Next >>

GoFiler Legato Script Reference — Generated on 12/16/2024

© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.