Skip to main content
Version: 4.1

Page

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.1.0.0)

Represents a web page that fills the browser and acts as the main container for the application. An application can have only one active main page at any given time.

public class Page : ContainerControl, IWisejWindow

To show the page assign it to the MainPage property.

Constructors

Instance member Page()

Initializes a new instance of the Page class.

Instance member Page(controls)

Initializes a new instance of the Page class with the specified initial settings.

NameTypeDescription
controlsControl[]An array of Control objects to be added to the form.

Properties

Instance member AcceptButton

IButtonControl: Returns or sets the button that is clicked when the user presses the ENTER key. (Default: null)

Instance member Active

Boolean: Returns true if this page instance is the currently active page. It is the same as comparing the instance with MainPage. (Default: False)

Static member ActivePage

Page: Returns the currently active page for this application. It's the same as MainPage, it is added to be consistent with ActiveForm.

Instance member AutoScroll

Boolean: Returns or sets whether the container enables the user to scroll to any controls placed outside of its visible boundaries. (Default: False)

Instance member AutoValidate

AutoValidate: Returns or sets how the control performs validation when the user changes focus to another control. (Default: EnablePreventFocusChange)

Instance member CancelButton

IButtonControl: Returns or sets the button control that is clicked when the user presses the ESC key. (Default: null)

Instance member ClientArea

Rectangle: Returns the client rectangle to use in the designer.

Instance member Height

Int32: Returns or sets the height of the page.

Instance member Size

Size: Returns the height and width of the page.

Instance member Text

String: Returns or sets the title of the Page. If the page is the main page, setting the text also changes the title in the browser. (Default: "")

Instance member Width

Int32: Returns or sets the width of the page.

Methods

Protected member Dispose(disposing)

Disposes the page and related resources.

ParameterTypeDescription
disposingBooleantrue when this method is called by the application rather than a finalizer.

Protected member GetScaledBounds(bounds, factor, specified)

ParameterTypeDescription
boundsRectangle
factorSizeF
specifiedBoundsSpecified

Returns: Rectangle.

Protected member OnActivated(e)

Fires the Activated event.

ParameterTypeDescription
eEventArgsA EventArgs that contains the event data.

Protected member OnCreateControl()

Raised when the control is created.

Protected member OnDeactivate(e)

Fires the Deactivate event.

ParameterTypeDescription
eEventArgsThe EventArgs that contains the event data.

Protected member OnLoad(e)

Fires the Load event.

ParameterTypeDescription
eEventArgsA EventArgs that contains the event data.

Protected member OnMouseDown(e)

ParameterTypeDescription
eMouseEventArgsA MouseEventArgs that contains the event data.

Protected member OnParentChanged(e)

Raises the ParentChanged event.

ParameterTypeDescription
eEventArgsA System.EventArgs that contains the event data.

Protected member OnWebEvent(e)

Processes the event from the client.

ParameterTypeDescription
eWisejEventArgsEvent arguments.

Protected member OnWebRender(config)

Renders the client component.

ParameterTypeDescription
configObjectDynamic configuration object.

Protected member OnWebUpdate(state)

Updates the client component using the state information.

ParameterTypeDescription
stateObjectDynamic state object.

Instance member ValidateChildren()

Validates all selectable child controls in the container, including descendants. This is equivalent to calling ValidateChildren(ValidationConstraints.Selectable). See Selectable for details of exactly which child controls will be validated.

Returns: Boolean. true if all of the children validated successfully; otherwise, false. If called from the Validating or Validated event handlers, this method will always return false.

Instance member ValidateChildren(flags)

Validates all the child controls in the container. Exactly which controls are validated and which controls are skipped is determined by flags .

ParameterTypeDescription
flagsValidationConstraintsPlaces restrictions on which controls have their Validating event raised.

Returns: Boolean. true if all of the children validated successfully; otherwise, false. If called from the Validating or Validated event handlers, this method will always return false.

Events

Instance member Activated

EventHandler Fired when the page becomes active, and it's the new MainPage.

Instance member Deactivate

EventHandler Fired when the page is deactivated and it's no longer the MainPage.

Instance member Load

EventHandler Fired before the control becomes visible for the first time.

Implements

NameDescription
IUserDataProvides access to the UserData and Tag properties associated to the component implementing this interface.
IBindableComponentBindable components implement this interface.
IContainerControlProvides the functionality for a control to act as a parent for other controls.
IDropTargetControls that support drag & drop operations implement this interface.
IWisejComponentAll wisej components implement this interface.
IWisejControlAll wisej controls derived from the Control class must implement this interface.
IWisejWindowAll wisej top-level windows implement this interface.
IWisejSerializableAllows an object to serialize itself.