Description
Obtains the height of the workspace within the boundaries of the specified window.
Applies to
Window objects
Syntax
windowname.WorkSpaceHeight ( )
|
Argument |
Description |
|---|---|
|
windowname |
The name of the window for which you want the height of the workspace area |
Return value
Integer.
Returns the height of the workspace area in PowerBuilder units in windowname. If an error occurs, WorkSpaceHeight returns -1. If windowname is null, WorkSpaceHeight returns null.
Usage
The workspace height does not include the thickness of the frame, the title bar, menu bar, horizontal scroll bar, or any toolbars at the top or bottom. The workspace height includes the MicroHelp status bar.
The workspace width does not include the thickness of the frame, the vertical scroll bar, or any toolbars on the left or right.
Examples
This example returns the height of the workspace area in the w_employee window:
Integer Height Height = W_employee.WorkSpaceHeight()
This example resizes the client area of a custom MDI frame window (that is, a frame window in which you have placed controls). P_logo is the control that has been placed on the window. The code belongs in the script for the frame's Resize event:
integer lw, lh
// Get the current workspace measurements
lw = This.WorkSpaceWidth()
lh = This.WorkSpaceHeight()
// Subtract the logo, MicroHelp from the height
lh = lh - (p_logo.Y + p_logo.Height)
lh = lh - MDI_1.MicroHelpHeight
// Add the distance between the top of the frame
// (just below the menu bar or toolbar, if any)
// and top of the workspace.
lh = lh + This.WorkspaceY( )
// Move the client area below the picture control
MDI_1.Move(This.WorkspaceX( ), &
p_logo.Y + p_logo.Height)
// Resize the client area using the calculated dims
mdi_1.Resize(lw, lh)See also
