Form (PRIM_FORM)

Form is a display area representing a window

Ancestors - Container (PRIM_CPST) Control (PRIM_CTRL) Object (PRIM_OBJT)

Details

A Form is a display area representing a window.
 
All LANSA desktop applications are started by executing a Form

Properties

NameDescription
BorderIconsSystem icons shown in the top right corner of the form
BusyCancelResultBusyCancelResult sets the behavior of the component during update operations
BusyUpdatesBusyUpdates specifies how the control updates itself Inherited from Control (PRIM_CTRL)
BusyUpdatesOfParentBusyUpdatesOfParent specifies whether the parent controls updates Inherited from Control (PRIM_CTRL)
CanFocusCanFocus returns a value indicating whether the control can receive keyboard focus Inherited from Control (PRIM_CTRL)
CaptionText shown in the title bar of the window
ClientHeightClientHeight specifies the height of the area inside the form
ClientWidthClientWidth specifies the width of the area inside the form
ComponentClassNameComponentClassName is the name of the component's class. Inherited from Object (PRIM_OBJT)
ComponentControlsComponentControls is a collection of all the controls contained in this component. Inherited from Container (PRIM_CPST)
ComponentMembersComponentMembers provides access to all the member components of this component Inherited from Object (PRIM_OBJT)
ComponentPatternNameComponentPatternName is used to qualify the class of the component. Inherited from Object (PRIM_OBJT)
ComponentTagGeneric space allowing a value to be stored for the instance Inherited from Object (PRIM_OBJT)
ComponentTypeComponentType gives you access to the type information about the component Inherited from Object (PRIM_OBJT)
ComponentTypeNameComponentTypeName is the fully qualified name of the component's class. Inherited from Object (PRIM_OBJT)
ComponentVersionVariant of the control being used
CursorCursor sets the cursor image Inherited from Control (PRIM_CTRL)
DisplayPositionDisplayPosition determines the order in which components are shown Inherited from Control (PRIM_CTRL)
DragStyleDragStyle determines how a component can be dragged Inherited from Control (PRIM_CTRL)
EnableChildrenEnableChildren specifies if the parent sets the Enabled property of child components Inherited from Container (PRIM_CPST)
EnabledEnable activates/deactivates the component Inherited from Control (PRIM_CTRL)
EnsureVisibleEnsure that a form is shown on a monitor that is active
FixedPositionFix the control position so that it does not move if the parent is scrolled Inherited from Control (PRIM_CTRL)
FocusFocus tells whether the component has focus Inherited from Control (PRIM_CTRL)
FocusedStyleReference to a style to be applied when the control is focus Inherited from Control (PRIM_CTRL)
FocusedStylesCollection of styles to be applied when the control is focus Inherited from Control (PRIM_CTRL)
FormOwnerThe form to which this form belongs in a stack of modal forms
FormPositionFormPosition specifies the form's position when first shown
FormStyleDetermines how the form behaves in a multiform application
FrameStyleFrameStyle sets the style of a form's frame
GlassAllows a form to use a semi-opaque glass background
HandleReturns the Windows handle in desktop applications Inherited from Control (PRIM_CTRL)
HeightThe height of the control in pixels Inherited from Control (PRIM_CTRL)
HintCaption displayed when the mouse hovers over the control Inherited from Control (PRIM_CTRL)
HintPopupHintPopup allows a PopupPanel instance to be used instead of the default hint text box Inherited from Control (PRIM_CTRL)
HintShowEnabled or disable the appearance of hints Inherited from Control (PRIM_CTRL)
HintShowOfParentDelegate hints appearance to the parent control Inherited from Control (PRIM_CTRL)
HintTitleHintTitle defines the text shown at the top of the hint window in emphasized text Inherited from Control (PRIM_CTRL)
IconImage displayed on the left side of the title bar
ImageImage displayed as the form background
ImageAlignmentPosition of the image within the form
IsAnimatingIsAnimating indicates that a control is currently being animated Inherited from Control (PRIM_CTRL)
IsRealizedTrue if the control is currently realized Inherited from Control (PRIM_CTRL)
LayoutManagerReference to a layout manager used to control the position of child controls
LeftPosition of the control relative to the left boundary of its parent Inherited from Control (PRIM_CTRL)
MenuBarReference to a menubar to be shown at the top of the form
ModalResultModalResult tells how a modal form was closed
ModifiedModified indicates that the contents of the component have changed Inherited from Control (PRIM_CTRL)
MouseOverMouseOver determines whether the mouse is directly over a control Inherited from Control (PRIM_CTRL)
MouseOverPartTrue if the cursor is within the bounds of a child component Inherited from Container (PRIM_CPST)
MouseOverStyleMouseOverStyle defines the style to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL)
MouseOverStylesMouseOverStyles is a collection of styles to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL)
NameName identifies the component Inherited from Object (PRIM_OBJT)
NormalHeightNormalHeight returns information about the height property of the form in its restored size
NormalLeftNormalLeft returns information about the left property of the form in its restored size
NormalTopNormalTop returns information about the top property of the form in its restored size
NormalWidthNormalWidth returns information about the width property of the form in its restored size
OpacityOpacity denotes the appearance of a control in terms of its interaction with its background Inherited from Control (PRIM_CTRL)
OwnerOwner owns this component Inherited from Object (PRIM_OBJT)
ParentThe starting form or owner of the application
PopupPopup allows a PopupPanel instance to be used instead of the typical right click popup menu Inherited from Control (PRIM_CTRL)
PopupMenuReference to a PopupMenu to be shown on a right click Inherited from Control (PRIM_CTRL)
PrivateStyleStyle applied to the control but not inherited by child controls Inherited from Container (PRIM_CPST)
PrivateStylesCollection of styles applied to the control but not inherited by child controls Inherited from Container (PRIM_CPST)
RenderStyleDefines the whether the form should render using DirectX, Win32 or defer to the application
RotationRotation allows a control to rotate a number of degrees about a given origin Inherited from Control (PRIM_CTRL)
RotationOriginLeftRotationOriginLeft defines the left coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL)
RotationOriginTopRotationOriginTop defines the top coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL)
ScaleHeightScaleHeight is the percentage of the height to use in the visual appearance of a control Inherited from Control (PRIM_CTRL)
ScaleOriginLeftScaleOriginLeft defines the left coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL)
ScaleOriginTopScaleOriginTop defines the top coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL)
ScaleWidthScaleWidth is the percentage of the width to use in the visual appearance of a control Inherited from Control (PRIM_CTRL)
ScalingFactorHorHorizontal scaling factor
ScalingFactorVerVertical scaling factor
ScreenLeftScreenLeft sets the distance from the left of the screen Inherited from Control (PRIM_CTRL)
ScreenTopScreenTop sets the distance from the top of the screen Inherited from Control (PRIM_CTRL)
ScrollLeftLeft position of a horizontally scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL)
ScrollTopTop position of a vertically scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL)
ShowInTaskbarDefines whether a form is shown in the Windows desktop Taskbar
SkewLeftSkewLeft defines the angle at which to skew the control horizontally Inherited from Control (PRIM_CTRL)
SkewOriginLeftSkewOriginLeft defines the left coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL)
SkewOriginTopSkewOriginTop defines the top coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL)
SkewTopSkewTop defines the angle at which to skew the control vertically Inherited from Control (PRIM_CTRL)
StyleStyle defines the style to be applied to a control Inherited from Control (PRIM_CTRL)
StylesCollection of styles to be applied to the control Inherited from Control (PRIM_CTRL)
TabPositionTabPosition sets the order of focus when the Tab key is used Inherited from Control (PRIM_CTRL)
TabStopSet to false to stop focus being given to the control via the Tab key Inherited from Control (PRIM_CTRL)
TaskbarReference to a form TaskBar instance allowing a form to interact with the Windows Task Bar
ThemeTheme is the name of the repository defined Theme to be used for this form.
ThemeDrawStyleName of the Theme DrawStyle to be applied to the form
ThemeStyleSpecifies how theme usage is determined
TitleBarVisibleTitleBarVisible hides/shows the title bar
TopPosition of the control relative to the top boundary of its parent Inherited from Control (PRIM_CTRL)
TouchMoveDetermines how the control will respond to touch move processing Inherited from Control (PRIM_CTRL)
TouchRotateDetermines how the control will respond to touch rotation Inherited from Control (PRIM_CTRL)
TouchScaleDetermines how the control will respond to touch scaling Inherited from Control (PRIM_CTRL)
TouchSizeDetermines whether a control can be resized Inherited from Control (PRIM_CTRL)
VisibleShow or hide the control Inherited from Control (PRIM_CTRL)
VisualStyleVisualStyle sets the appearance Inherited from Control (PRIM_CTRL)
VisualStyleOfParentAdopt the Visual style from the parent control Inherited from Control (PRIM_CTRL)
WidthWidth of the component in pixels Inherited from Control (PRIM_CTRL)
WindowStateWindowState controls how the window is displayed

Events

NameDescription
ActivateFired when the form becomes the active window
AnimationEndedFired when an animation is ended Inherited from Form (PRIM_FORM)
Cancelled
ClickFired when the mouse is clicked on the control
Origin, Handled
CloseQueryFired when the form is about to close
Continue
ClosingClosing event happens when the user closes the form
Action
CreateInstanceCreateInstance is signalled when an instance of a component is created Inherited from Form (PRIM_FORM)
DeactivateDeactivate event happens when the form is deactivated
DestroyInstanceDestroyInstance is signalled when an instance of a component is about to be destroyed Inherited from Form (PRIM_FORM)
DoubleClickFired when the user double clicks
Origin, Handled
DragDropFired on mouse up to signify the end of a drag process Inherited from Form (PRIM_FORM)
PosX, PosY, Source, Payload, AggregatedSource, Origin, Handled, DragResult
DragOverFired during the drag and drop process when the cursor moves over the control Inherited from Form (PRIM_FORM)
PosX, PosY, Source, Payload, DragState, AcceptDrop, DragCursor, ShowDropHilight, AggregatedSource, Origin, Handled
EndDragFired when the drag and drop process has completed Inherited from Form (PRIM_FORM)
Source, Payload, DragResult, AggregatedSource, Origin, Handled
GotFocusFired when the control receives the focus
InitializeFired after a component has been realized for the first time Inherited from Form (PRIM_FORM)
LostFocusLostFocus happens when a component is no longer active
MouseEnterThe mouse has entered the bounds of the control Inherited from Form (PRIM_FORM)
MouseHoverThe mouse has hovered over the control Inherited from Form (PRIM_FORM)
Origin, Handled
MouseLeaveThe mouse has left the bounds of the control Inherited from Form (PRIM_FORM)
SizeChangedThe form has changed size
StartDragFired when the user starts a drag and drop process Inherited from Form (PRIM_FORM)
Source, Payload, Continue, DragList, AggregatedSource, Origin, Handled
TouchChangeFired repeatedly between the TouchStart and TouchEnd boundaries to provide details of the touch events Inherited from Form (PRIM_FORM)
MoveLeft, MoveTop, ScaleWidth, ScaleHeight, Rotation, Continue
TouchEndFired when the user stops touching the screen Inherited from Form (PRIM_FORM)
TouchStartFired when the user first makes physical contact with the screen Inherited from Form (PRIM_FORM)
Origin, TouchMove, TouchRotate, TouchScale, TouchSize

Methods

NameDescription
ActivateFormForces the form to become the active window
CloseFormCloseForm closes the form
CloseFormQueryClose the form and fire the CloseFormQuery event to allow for confirmation
FadeInAnimate from invisible to visible Inherited from Control (PRIM_CTRL)
Duration, Delay
FadeOutAnimate from visible to invisible Inherited from Control (PRIM_CTRL)
Duration, Delay, Visible
HideFormHideForm hides the form
MaximizeFormMaximizeForm maximizes the form so the it fills the screen
MinimizeFormMinimizeForm minimizes the form
MoveFromMove a control from the specified position to the current position Inherited from Control (PRIM_CTRL)
Left, Top, Duration, Delay
MoveToAnimate a move from the specified number of pixels Inherited from Control (PRIM_CTRL)
Left, Top, Duration, Delay
RealizeCreates the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL)
RestoreFormRestoreForm method restores the form's size
ScaleAnimate a change of scale Inherited from Control (PRIM_CTRL)
ScaleWidth, ScaleHeight, Duration, Delay
SetFocusSets the control to be the focus control Inherited from Control (PRIM_CTRL)
ShowFormShowForm shows the form
ShowMessagesLANSA Internal Use Inherited from Control (PRIM_CTRL)
ShowModalFormShowModalForm method shows the form and makes it modal
TransitionAnimate the change from one control to another Inherited from Container (PRIM_CPST)
From, To, TransitionType, Duration, Delay
UnrealizeDestroys the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL)
UpdateDisplayUpdateDisplay updates the display immediately Inherited from Control (PRIM_CTRL)

See also

All Component Classes

Technical Reference

Febuary 18 V14SP2