WorkSpaceHeight
PowerScript function
Description
Obtains the height of the workspace within the boundaries of the
specified window.
Applies to
Window objects
Syntax
|
1 |
windowname.WorkSpaceHeight ( ) |
|
Argument |
Description |
|---|---|
|
windowname |
The name of the window for which you want the height of |
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:
|
1 2 |
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:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
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