Only this pageAll pages
Powered by GitBook
Couldn't generate the PDF for 640 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

v2.2

Loading...

Wisej.Web

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

General

Welcome

This book covers the full API for the Wisej.Framework assembly only. For an in-depth guide of Wisej features, please refer to the Concepts book. For the extensions API and concepts, please refer to the Extensions book.

Legend

Icon
Description

Instance method, or property, or event.

Static method or property or event.

Protected method or property or event.

Deprecated method or property or event.

Concepts & Reference

This is the API book, for the concepts documentation please refer to the link below. The concept documentation and the namespace reference are a never-ending work in progress. We update it almost daily. Please check back if what you are looking for is not available.

Skills

We assume that you have a good working knowledge of the following tools and technologies:

  • C# or VB.NET

  • .NET in general

  • Visual Studio

  • JavaScript

Application.PageCollection

Wisej.Web.Application PageCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Holds the collection of all top-level application pages.

Properties

Count

: Returns the total number of currently open pages.

Item(index)

: Returns the page at the specified index.

Item(name)

: Returns the first page with the specified name, the search is case insensitive.

Methods

GetEnumerator()

Returns an enumerator that iterates through the open pages.

Returns: .

HelpEventHandler

Wisej.Web.HelpEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event of a .

Parameters

Name
Type
Description

Fired By

Name
Description

HashChangedEventArgs

Wisej.Web.HashChangedEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

HashChangedEventArgs(value)

Initializes a new instance of the class.

Name
Type
Description

Properties

Hash

: The hash string from the client.

Used By

Name
Description

sender

Object

The source of the event.

hlpevent

HelpEventArgs

A HelpEventArgs object that contains the event data.

Control.HelpRequested

Fired when the user requests help for a control by pressing F1.

HelpRequested
Control
Public Delegate Sub HelpEventHandler(ByVal sender As [Object], ByVal hlpevent As HelpEventArgs)

value

String

Initial hash value.

HashChangedEventHandler

Represents the method that will handle the HashChanged event.

HashChanged
Public Class HashChangedEventArgs
    Inherits EventArgs
HashChangedEventArgs
String
Public Class PageCollection
    Inherits ICollection
    Implements IEnumerable
Int32
Page
Page
IEnumerator

ResponsiveProfileChangedEventArgs

Wisej.Web.ResponsiveProfileChangedEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the ResponsiveProfileChanged event.

Public Class ResponsiveProfileChangedEventArgs
    Inherits EventArgs

Constructors

ResponsiveProfileChangedEventArgs(oldValue, newValue)

Initializes a new instance of the ResponsiveProfileChangedEventArgs class.

Name
Type
Description

oldValue

Previous .

newValue

New active .

Properties

CurrentProfile

ClientProfile: The new active profile.

PreviousProfile

ClientProfile: The previously active profile.

Used By

Name
Description

Represents the method that will handle the Application.ResponsiveProfileChanged event.

HelpEventArgs

Wisej.Web.HelpEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the HelpRequested event.

Public Class HelpEventArgs
    Inherits EventArgs

Constructors

HelpEventArgs(target)

Initializes a new instance of the HelpEventArgs class.

Name
Type
Description

target

The that had the focus when the user pressed F1.

Properties

Handled

Boolean: Returns or sets a value indicating whether the help event was handled.

Target

Control: Returns the Control that had the focus when the user pressed F1.

Used By

Name
Description

Represents the method that will handle the event of a .

ControlEventHandler

Wisej.Web.ControlEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the ControlAdded and ControlRemoved events of the Control class.

Public Delegate Sub ControlEventHandler(ByVal sender As [Object], ByVal e As ControlEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when a multiple-document interface (MDI) child form is added to the mdi parent.

Fired when a multiple-document interface (MDI) child form is removed from the mdi parent.

ControlEventArgs

Wisej.Web.ControlEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the ControlAdded and ControlRemoved events.

Public Class ControlEventArgs
    Inherits EventArgs

Constructors

ControlEventArgs(control)

Initializes a new instance of the ControlEventArgs class for the specified control.

Name
Type
Description

control

The to store in this event.

Properties

Control

Control: Returns the control object used by this event.

Used By

Name
Description

Represents the method that will handle the and events of the class.

ResponsiveProfileChangedEventHandler

Wisej.Web.ResponsiveProfileChangedEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the Application.ResponsiveProfileChanged event.

Public Delegate Sub ResponsiveProfileChangedEventHandler(ByVal sender As [Object], ByVal e As ResponsiveProfileChangedEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when the active responsive profile is changed.

Fired when the active responsive profile is changed.

KeyPressEventArgs

Wisej.Web.KeyPressEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

KeyPressEventArgs(keyChar)

Initializes a new instance of the class.

Name
Type
Description

Properties

Handled

: Returns or sets whether the event was handled.

KeyChar

: Returns or sets the character corresponding to the key pressed.

Used By

Name
Description

PinchEventHandler

Wisej.Web.PinchEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event.

Parameters

Name
Type
Description

Fired By

Name
Description

Common Dialogs

public delegate void HelpEventHandler(Object sender, HelpEventArgs hlpevent)
Object
ControlEventArgs
ControlEventArgs
Form.MdiChildAdded
Form.MdiChildRemoved
public delegate void ControlEventHandler(Object sender, ControlEventArgs e)
Object
ResponsiveProfileChangedEventArgs
ResponsiveProfileChangedEventArgs
Control.ResponsiveProfileChanged
Application.ResponsiveProfileChanged
public delegate void ResponsiveProfileChangedEventHandler(Object sender, ResponsiveProfileChangedEventArgs e)

sender

Object

The source of the event.

e

PinchEventArgs

A PinchEventArgs that contains the event data.

Control.Pinch

Fired when two finger moved towards or away from each other. It contains the scaling factor of the pinch.

Pinch
Public Delegate Sub PinchEventHandler(ByVal sender As [Object], ByVal e As PinchEventArgs)
public delegate void PinchEventHandler(Object sender, PinchEventArgs e)

keyChar

Char

The ASCII character corresponding to the key the user pressed.

KeyPressEventHandler

Represents the method that will handle the KeyPress event of a Control.

KeyPress
Public Class KeyPressEventArgs
    Inherits EventArgs
KeyPressEventArgs
Boolean
KeyPress
Char
public class KeyPressEventArgs : EventArgs
ClientProfile
ClientProfile
ClientProfile
ClientProfile
ResponsiveProfileChangedEventHandler
public class ResponsiveProfileChangedEventArgs : EventArgs
Control
Control
HelpEventHandler
HelpRequested
Control
public class HelpEventArgs : EventArgs
Control
Control
ControlEventHandler
ControlAdded
ControlRemoved
Control
public class ControlEventArgs : EventArgs

KeyEventArgs

Wisej.Web.KeyEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the KeyDown or KeyUp event.

public class KeyEventArgs : EventArgs
Public Class KeyEventArgs
    Inherits EventArgs

Constructors

KeyEventArgs(keyData)

Initializes a new instance of the KeyEventArgs class.

Name
Type
Description

keyData

A representing the key that was pressed, combined with any modifier flags that indicate which CTRL, SHIFT, and ALT keys were pressed at the same time. Possible values are obtained be applying the bitwise OR (|) operator to constants from the enumeration.

Properties

Alt

Boolean: Returns whether the ALT key was pressed.

Control

Boolean: Returns whether the CTRL key was pressed.

Handled

Boolean: Returns or sets whether the event was handled.

KeyCode

Keys: Returns the keyboard code..

KeyData

Keys: Returns the key data.

KeyValue

Int32: Returns the keyboard value.

Modifiers

Keys: Returns the modifier flags indicating which combination of CTRL, SHIFT, and ALT keys was pressed.

Shift

Boolean: Returns a value indicating whether the SHIFT key was pressed.

Methods

IsAltPressed()

Returns whether the Alt key is pressed.

Returns: Boolean.

IsCtrlPressed()

Returns whether the Control key is pressed.

Returns: Boolean.

IsShiftPressed()

Returns whether the Shift key is pressed.

Returns: Boolean.

Used By

Name
Description

Represents the method that will handle the or event of a .

public class PageCollection : ICollection, IEnumerable
public class HashChangedEventArgs : EventArgs

Containers

Keys
Keys
Keys
KeyEventHandler
KeyUp
KeyDown
Control

MenuButtonItemClickedEventHandler

Wisej.Web.MenuButtonItemClickedEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the ItemClicked event of a Button control.

public delegate void MenuButtonItemClickedEventHandler(Object sender, MenuButtonItemClickedEventArgs e)
Public Delegate Sub MenuButtonItemClickedEventHandler(ByVal sender As [Object], ByVal e As MenuButtonItemClickedEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when the user clicks one of the drop down menu items.

PaintEventArgs

Wisej.Web.PaintEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the Paint event.

public class PaintEventArgs : EventArgs
Public Class PaintEventArgs
    Inherits EventArgs

Constructors

PaintEventArgs(graphics, clipRect)

Initializes a new instance of the PaintEventArgs class with the specified graphics and clipping rectangle.

Name
Type
Description

graphics

The used to paint the item.

clipRect

The that represents the rectangle in which to paint.

Properties

ClipRectangle

Rectangle: Returns the rectangle in which to paint.

Graphics

Graphics: Returns the graphics used to paint.

Used By

Name
Description

Represents the method that will handle the event of a .

FileDialogLoadPathEventHandler

Wisej.Web.FileDialogLoadPathEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the LoadPath and LoadPath events.

public delegate void FileDialogLoadPathEventHandler(Object sender, FileDialogLoadPathEventArgs e)
Public Delegate Sub FileDialogLoadPathEventHandler(ByVal sender As [Object], ByVal e As FileDialogLoadPathEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when the file dialog is loading a file or folder.

Fired when the file dialog is loading a file or folder.

PreviewKeyDownEventHandler

Wisej.Web.PreviewKeyDownEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the PreviewKeyDown event.

public delegate void PreviewKeyDownEventHandler(Object sender, PreviewKeyDownEventArgs e)
Public Delegate Sub PreviewKeyDownEventHandler(ByVal sender As [Object], ByVal e As PreviewKeyDownEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired before the event when a key is pressed while focus is on this control.

AcceleratorEventArgs

Wisej.Web.AcceleratorEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

AcceleratorEventArgs(keyData, component)

Initializes a new instance of the class.

Name
Type
Description

Properties

Component

: Returns the Wisej component that generated the "keydown" event'.

Used By

Name
Description

MenuButtonItemClickedEventArgs

Wisej.Web.MenuButtonItemClickedEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

MenuButtonItemClickedEventArgs(item)

Initializes a new instance of the class.

Name
Type
Description

Properties

Item

: Returns the clicked menu item.

Used By

Name
Description

TrackEventArgs

Wisej.Web.TrackEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for event.

Properties

Axis

: Returns the Axis of the track event.

Location

: Returns the X, Y delta for the track event.

X

: Returns the X delta of the track event.

Y

: Returns Y delta of the track event.

Used By

Name
Description

SwipeEventArgs

Wisej.Web.SwipeEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for event.

Properties

Axis

: Returns whether the performed swipe was on the x or y axis.

Direction

: Returns the direction of the performed swipe in reference to the axis: X = Up / Down Y = Left / Right

Distance

: Returns the distance of the performed swipe.

Duration

: Returns the duration the performed swipe took.

StartTime

: Returns the start time of the performed swipe.

Velocity

: Returns the velocity of the performed swipe.

Used By

Name
Description

DataRepeaterItemCloneEventHandler

Wisej.Web.DataRepeaterItemCloneEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event.

Parameters

Name
Type
Description

Fired By

Name
Description

DataRepeaterDataErrorEventHandler

Wisej.Web.DataRepeaterDataErrorEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event.

Parameters

Name
Type
Description

Fired By

Name
Description

DataRepeaterItemEventHandler

Wisej.Web.DataRepeaterItemEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event.

Parameters

Name
Type
Description

Fired By

Name
Description

DesktopTaskBarItemClickEventHandler

Wisej.Web.DesktopTaskBarItemClickEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event of a .

Parameters

Name
Type
Description

Fired By

Name
Description

DataRepeaterAddRemoveItemsCancelEventArgs

Wisej.Web.DataRepeaterAddRemoveItemsCancelEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

DataRepeaterAddRemoveItemsCancelEventArgs(index, count)

Initializes a new instance of the class.

Name
Type
Description

Properties

ItemCount

: Gets the number of items being deleted.

ItemIndex

: Returns the index of the item that is being deleted.

Used By

Name
Description

DataRepeaterItemValueEventHandler

Wisej.Web.DataRepeaterItemValueEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the and events.

Parameters

Name
Type
Description

Fired By

Name
Description

TouchEventHandler

Wisej.Web.TouchEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the , , , events.

Parameters

Name
Type
Description

Fired By

Name
Description

ResponsiveProfileChangedEventHandler

Wisej.Web.ResponsiveProfileChangedEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the Application.ResponsiveProfileChanged event.

Parameters

Name
Type
Description

Fired By

Name
Description

AccordionEventHandler

Wisej.Web.AccordionEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the or event of a control.

Parameters

Name
Type
Description

Fired By

Name
Description

Screen

Wisej.Web.Screen

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents a display device or multiple display devices on a single system.

Properties

Bounds

: Returns the bounds of the display.

DeviceName

: Returns the device name associated with a display.

WorkingArea

: Returns the working area of the browser. The working area is the desktop area of the browser, excluding taskbars, docked windows, and docked tool bars.

Object
MenuButtonItemClickedEventArgs
MenuButtonItemClickedEventArgs
Button.ItemClicked
Object
FileDialogLoadPathEventArgs
FileDialogLoadPathEventArgs
FileDialog.LoadPath
FolderBrowserDialog.LoadPath
Object
PreviewKeyDownEventArgs
PreviewKeyDownEventArgs
Control.PreviewKeyDown
KeyDown

sender

Object

The source of the event.

e

DataRepeaterItemCloneEventArgs

A DataRepeaterItemCloneEventArgs object that contains the event data.

DataRepeater.ItemCloning

Fired before the DataRepeaterItem and its controls are cloned from the ItemTemplate.

ItemCloning
Public Delegate Sub DataRepeaterItemCloneEventHandler(ByVal sender As [Object], ByVal e As DataRepeaterItemCloneEventArgs)
public delegate void DataRepeaterItemCloneEventHandler(Object sender, DataRepeaterItemCloneEventArgs e)

sender

Object

The source of the event.

e

DataRepeaterDataErrorEventArgs

A DataRepeaterDataErrorEventArgs object that contains the event data.

DataRepeater.DataError

Fired when an external data-parsing or validation operation throws an exception, or when an attempt to commit data to a data source fails.

DataError
Public Delegate Sub DataRepeaterDataErrorEventHandler(ByVal sender As [Object], ByVal e As DataRepeaterDataErrorEventArgs)
public delegate void DataRepeaterDataErrorEventHandler(Object sender, DataRepeaterDataErrorEventArgs e)

sender

Object

The source of the event.

e

DataRepeaterItemEventArgs

A DataRepeaterItemEventArgs object that contains the event data.

DataRepeater.ItemCloned

Fired after the DataRepeaterItem and its controls are cloned from the ItemTemplate.

DataRepeater.ItemSelected

Fired after the DataRepeaterItem becomes the current item.

DataRepeater.ItemUpdate

Fired when an instance of DataRepeaterItem is updated.

ItemCloned
Public Delegate Sub DataRepeaterItemEventHandler(ByVal sender As [Object], ByVal e As DataRepeaterItemEventArgs)
public delegate void DataRepeaterItemEventHandler(Object sender, DataRepeaterItemEventArgs e)

sender

Object

The source of the event.

e

DesktopTaskBarItemClickEventArgs

A DesktopTaskBarItemClickEventArgs that contains the event data.

Desktop.ItemClick

Fired when a DesktopTaskBarItem on the Desktop is clicked.

Desktop.ItemDoubleClick

Fired when a DesktopTaskBarItem on the Desktop is double clicked.

ItemClick
Desktop
Public Delegate Sub DesktopTaskBarItemClickEventHandler(ByVal sender As [Object], ByVal e As DesktopTaskBarItemClickEventArgs)
public delegate void DesktopTaskBarItemClickEventHandler(Object sender, DesktopTaskBarItemClickEventArgs e)

sender

Object

The source of the event.

e

DataRepeaterItemValueEventArgs

A DataRepeaterItemValueEventArgs object that contains the event data.

DataRepeater.ItemValueNeeded

Fired when the VirtualMode property is set to true and a new value for a child control of a DataRepeaterItem is needed.

DataRepeater.ItemValuePushed

Fired when the VirtualMode property is set to true and the value of a child control in the DataRepeaterItem changes.

ItemValueNeeded
ItemValuePushed
Public Delegate Sub DataRepeaterItemValueEventHandler(ByVal sender As [Object], ByVal e As DataRepeaterItemValueEventArgs)
public delegate void DataRepeaterItemValueEventHandler(Object sender, DataRepeaterItemValueEventArgs e)

sender

Object

The source of the event.

e

TouchEventArgs

A TouchEventArgs that contains the event data.

Control.TouchStart

Fired when a touch point is placed on the touch surface.

Control.TouchEnd

Fired when a touch point is removed from the touch surface.

Control.TouchCancel

Fired when a touch point has been disrupted in an implementation-specific manner (for example, too many touch points are created).

Control.TouchMove

Fired when a touch point is moved along the touch surface.

TouchStart
TouchEnd
TouchMove
TouchCancel
Public Delegate Sub TouchEventHandler(ByVal sender As [Object], ByVal e As TouchEventArgs)
public delegate void TouchEventHandler(Object sender, TouchEventArgs e)

sender

Object

The source of the event.

e

ResponsiveProfileChangedEventArgs

A ResponsiveProfileChangedEventArgs that contains the event data.

Control.ResponsiveProfileChanged

Fired when the active responsive profile is changed.

Application.ResponsiveProfileChanged

Fired when the active responsive profile is changed.

Public Delegate Sub ResponsiveProfileChangedEventHandler(ByVal sender As [Object], ByVal e As ResponsiveProfileChangedEventArgs)
public delegate void ResponsiveProfileChangedEventHandler(Object sender, ResponsiveProfileChangedEventArgs e)

sender

Object

The source of the event.

e

AccordionEventArgs

A AccordionEventArgs that contains the event data.

Accordion.Selected

Fired when a panel is selected.

Accordion.Deselected

Fired when a panel is deselected.

Selected
Deselected
Accordion
Public Delegate Sub AccordionEventHandler(ByVal sender As [Object], ByVal e As AccordionEventArgs)
public delegate void AccordionEventHandler(Object sender, AccordionEventArgs e)

Buttons

keyData

Keys

A Keys representing the key that was pressed, combined with any modifier flags that indicate which CTRL, SHIFT, and ALT keys were pressed at the same time. Possible values are obtained be applying the bitwise OR (|) operator to constants from the Keys enumeration.

component

IWisejComponent

The Wisej component that originated the keyboard event.

AcceleratorEventHandler

Represents the method that will handle the Accelerator event.

KeyEventArgs
AcceleratorEventArgs
Accelerator
Public Class AcceleratorEventArgs
    Inherits KeyEventArgs
KeyEventArgs
IWisejComponent
public class AcceleratorEventArgs : KeyEventArgs

item

MenuItem

The MenuItem that was clicked.

MenuButtonItemClickedEventHandler

Represents the method that will handle the ItemClicked event of a Button control.

ItemClicked
Public Class MenuButtonItemClickedEventArgs
    Inherits EventArgs
MenuButtonItemClickedEventArgs
MenuItem
public class MenuButtonItemClickedEventArgs : EventArgs

TrackEventHandler

Represents the method that will handle the Track event.

Track
Public Class TrackEventArgs
    Inherits EventArgs
SwipeAxis
Point
Int32
Int32
public class TrackEventArgs : EventArgs

SwipeEventHandler

Represents the method that will handle the Swipe event.

Swipe
Public Class SwipeEventArgs
    Inherits EventArgs
SwipeAxis
SwipeDirection
Int32
Int32
Int64
Double
public class SwipeEventArgs : EventArgs

index

Int32

The index of the DataRepeaterItem that is being deleted.

count

Int32

The number of items being deleted.

DataRepeaterAddRemoveItemsCancelEventHandler

Represents the method that handles the UserDeletingItems event.

UserDeletingItems
Public Class DataRepeaterAddRemoveItemsCancelEventArgs
    Inherits CancelEventArgs
DataRepeaterAddRemoveItemsCancelEventArgs
Int32
Int32
public class DataRepeaterAddRemoveItemsCancelEventArgs : CancelEventArgs
IntroductionWisej
Graphics
Graphics
Rectangle
Rectangle
PaintEventHandler
Paint
Control
Public Class Screen
Rectangle
String
Rectangle
public class Screen

PreviewKeyDownEventArgs

Wisej.Web.PreviewKeyDownEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the PreviewKeyDown event.

public class PreviewKeyDownEventArgs : EventArgs
Public Class PreviewKeyDownEventArgs
    Inherits EventArgs

Constructors

PreviewKeyDownEventArgs(keyData)

Initializes a new instance of the PreviewKeyDownEventArgs class with the specified key.

Name
Type
Description

keyData

One of the values.

Properties

Alt

Boolean: Returns whether the ALT key was pressed.

Control

Boolean: Returns whether the CTRL key was pressed.

IsInputKey

Boolean: Returns whether a key is a regular input key.

KeyCode

Keys: Returns the keyboard code.

KeyData

Keys: Returns the key data.

KeyValue

Int32: Returns the keyboard value.

Modifiers

Keys: Returns the modifier flags indicating which combination of CTRL, SHIFT, and ALT keys was pressed.

Shift

Boolean: Returns whether the SHIFT key was pressed.

Used By

Name
Description

Represents the method that will handle the event.

FolderBrowserDialogUI

Wisej.Web.FolderBrowserDialogUI

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ScrollableControl

      • ContainerControl

        • Form

          • FolderBrowserDialogUI

UI implementation for the FolderDialog class.

public class FolderBrowserDialogUI : Form
Public Class FolderBrowserDialogUI
    Inherits Form

Constructors

FolderBrowserDialogUI()

FolderBrowserDialogUI(folderDialog)

Name
Type
Description

folderDialog

Implements

Name
Description

Bindable components implement this interface.

Provides the functionality for a control to act as a parent for other controls.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

All wisej top-level windows implement this interface.

Allows an object to serialize itself.

AccordionCancelEventHandler

Wisej.Web.AccordionCancelEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the Selecting or Deselecting event of a Accordion control.

public delegate void AccordionCancelEventHandler(Object sender, AccordionCancelEventArgs e)
Public Delegate Sub AccordionCancelEventHandler(ByVal sender As [Object], ByVal e As AccordionCancelEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Occurs before a panel is selected, enabling a handler to cancel the panel change.

Occurs before a panel is deselected, enabling a handler to cancel the panel change.

AccordionAction

Wisej.Web.AccordionAction

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Defines values representing Accordion events.

public enum AccordionAction : Enum
Public Enum AccordionAction As [Enum]

Fields

Name
Description

Deselected

Represents the event.

Deselecting

Represents the event.

Selected

Represents the event.

Selecting

Represents the event.

Used By

Name
Description

Returns a value indicating which event is occurring.

Returns a value indicating which event is occurring.

DragEventHandler

Wisej.Web.DragEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the DragDrop, DragEnter, or DragOver event of a Control.

public delegate void DragEventHandler(Object sender, DragEventArgs e)
Public Delegate Sub DragEventHandler(ByVal sender As [Object], ByVal e As DragEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when a drag-and-drop operation is completed.

Fired when an object is dragged into the control's bounds.

Fired when an object is dragged over the control's bounds.

LayoutEventArgs

Wisej.Web.LayoutEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

LayoutEventArgs(affectedComponent, affectedProperty)

Initializes a new instance of the class with the specified component and property affected.

Name
Type
Description

LayoutEventArgs(affectedControl, affectedProperty)

Initializes a new instance of the class with the specified control and property affected.

Name
Type
Description

Properties

AffectedComponent

: Returns the affected by the layout change.

AffectedControl

: Returns the child control affected by the change.

AffectedProperty

: Returns the property affected by the change.

Used By

Name
Description

AccordionCancelEventArgs

Wisej.Web.AccordionCancelEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the and events of a control.

Constructors

AccordionCancelEventArgs(panel, panelIndex, cancel, action)

Initializes a new instance of the class.

Name
Type
Description

Properties

Action

: Returns a value indicating which event is occurring.

Panel

: Returns the the event is occurring for.

PanelIndex

: Returns the zero-based index of the in the collection.

Used By

Name
Description

DataRepeaterAddRemoveItemsEventArgs

Wisej.Web.DataRepeaterAddRemoveItemsEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the , , , and events.

Constructors

DataRepeaterAddRemoveItemsEventArgs(index, count)

Initializes a new instance of the class.

Name
Type
Description

Properties

ItemCount

: Return the number of items being added to or deleted from a control.

ItemIndex

: Returns the index of the item being added or deleted.

Used By

Name
Description

DesktopTaskBarItemClickEventArgs

Wisej.Web.DesktopTaskBarItemClickEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

DesktopTaskBarItemClickEventArgs(item, button, clicks)

Initializes a new instance of the class.

Name
Type
Description

Properties

Item

: Returns or sets the that was clicked.

Used By

Name
Description

OpenFileDialog

Wisej.Web.OpenFileDialog

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Prompts the user to open a file from the server.

You can:

  • Override . It's called when the specified file doesn't exist and the property is true.

  • Override to create your custom when the method is called.

  • Set the to a class that has a constructor that accepts as the single argument to change the User Interface (UI) of the file dialog.

  • Override to provide your custom implementation of the actions to execute when the user presses the OK button.

You must add at least one to the collection before showing the dialog.

Constructors

OpenFileDialog()

Initializes a new instance of .

OpenFileDialog(container)

Initializes a new instance of the extender with a specified container.

Name
Type
Description

Properties

CheckFileExists

: Returns or sets a value indicating whether the dialog box displays a warning if the user specifies a file name that does not exist.

Multiselect

: Returns or sets a value indicating whether the dialog box allows multiple files to be selected.

SafeFileName

: Returns the file name and extension for the file selected in the dialog box. The file name does not include the path.

SafeFileNames

: Returns an array of file names and extensions for all the selected files in the dialog box. The file names do not include the path.

Methods

OpenFile()

Opens the file selected by the user, with read-only permission. The file is specified by the property.

Returns: . A that specifies the read-only file selected by the user.

Throws:

  • is empty or null.

Reset()

Resets all properties to their default values.

FileDialogLoadPathEventArgs

Wisej.Web.FileDialogLoadPathEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the LoadPath event.

Allows an application to filter the files and folders loaded by the and components and to set the icon, creation date and modified date. To skip a file or folder, set e.Cancel = true. To set a file's icon, or date, set the , or properties.

Constructors

FileDialogLoadPathEventArgs(path, isDirectory)

Constructs a new instance of .

Name
Type
Description

Properties

CreationTime

: Sets the creation DateTime of the file.

FileSize

: Sets the file size in bytes.

ImageSource

: Sets the name or path of the icon to display next to the file.

IsDirectory

: Returns true when the refers to a directory.

LastWriteTime

: Sets the last modified DateTime of the file.

Path

: Returns the full path of the file or folder being loaded.

Used By

Name
Description

FileDialogUI

Wisej.Web.FileDialogUI

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

UI implementation for the FileDialog class.

Constructors

FileDialogUI()

FileDialogUI(fileDialog)

Name
Type
Description

Implements

Name
Description

DataRepeaterAddRemoveItemsCancelEventHandler

Wisej.Web.DataRepeaterAddRemoveItemsCancelEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that handles the event.

Parameters

Name
Type
Description

Fired By

Name
Description

DataRepeaterLayoutStyles

Wisej.Web.DataRepeaterLayoutStyles

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides an enumeration for specifying the orientation of items in a control.

Fields

Name
Description

Used By

Name
Description
Object
AccordionCancelEventArgs
AccordionCancelEventArgs
Accordion.Selecting
Accordion.Deselecting
Deselected
Deselecting
Selected
Selecting
AccordionCancelEventArgs.Action
AccordionEventArgs.Action
Object
DragEventArgs
DragEventArgs
Control.DragDrop
Control.DragEnter
Control.DragOver

sender

Object

The source of the event.

e

DataRepeaterAddRemoveItemsCancelEventArgs

An object that contains the event data.

DataRepeater.UserDeletingItems

Fired when the user deletes a DataRepeaterItem.

UserDeletingItems
Public Delegate Sub DataRepeaterAddRemoveItemsCancelEventHandler(ByVal sender As [Object], ByVal e As DataRepeaterAddRemoveItemsCancelEventArgs)
public delegate void DataRepeaterAddRemoveItemsCancelEventHandler(Object sender, DataRepeaterAddRemoveItemsCancelEventArgs e)

Horizontal

Items are displayed in a horizontal format. A horizontal scroll bar will be displayed as necessary.

Vertical

Items are displayed in a vertical format. A vertical scroll bar will be displayed as necessary.

DataRepeater.LayoutStyle

Return or sets whether the DataRepeater control will be displayed with a vertical or horizontal orientation.

DataRepeater
Public Enum DataRepeaterLayoutStyles As [Enum]
public enum DataRepeaterLayoutStyles : Enum

affectedComponent

IComponent

The IComponent affected by the layout change.

affectedProperty

String

The property affected by the layout change.

affectedControl

Control

The Control affected by the layout change.

affectedProperty

String

The property affected by the layout change.

LayoutEventHandler

Represents the method that will handle the Layout event of a Control.

Layout
Public Class LayoutEventArgs
    Inherits EventArgs
LayoutEventArgs
LayoutEventArgs
IComponent
IComponent
Control
String
public class LayoutEventArgs : EventArgs

panel

AccordionPanel

The AccordionPanel the event is occurring for.

panelIndex

Int32

The zero-based index of panel in the Panels collection.

cancel

Boolean

true to cancel the panel change by default; otherwise, false.

action

AccordionAction

One of the AccordionAction values.

AccordionCancelEventHandler

Represents the method that will handle the Selecting or Deselecting event of a Accordion control.

Selecting
Deselecting
Accordion
Public Class AccordionCancelEventArgs
    Inherits CancelEventArgs
AccordionCancelEventArgs
AccordionAction
AccordionPanel
AccordionPanel
Int32
Panel
Panels
public class AccordionCancelEventArgs : CancelEventArgs

index

Int32

The index of the DataRepeaterItem that is being added or deleted.

count

Int32

The number of items being added or deleted.

DataRepeaterAddRemoveItemsEventHandler

Represents the method that will handle the ItemsAdded, ItemsRemoved, UserAddedItems, and UserDeletedItems events.

ItemsAdded
ItemsRemoved
UserAddedItems
UserDeletedItems
Public Class DataRepeaterAddRemoveItemsEventArgs
    Inherits EventArgs
DataRepeaterAddRemoveItemsEventArgs
Int32
DataRepeater
Int32
public class DataRepeaterAddRemoveItemsEventArgs : EventArgs

item

DesktopTaskBarItem

The DesktopTaskBarItem that was clicked.

button

MouseButtons

One of the MouseButtons values that indicate which mouse button was pressed.

clicks

Int32

The number of times a mouse button was pressed.

DesktopTaskBarItemClickEventHandler

Represents the method that will handle the ItemClick event of a Desktop.

MouseEventArgs
DesktopTaskBarItemClickEventArgs
ItemClick
Public Class DesktopTaskBarItemClickEventArgs
    Inherits MouseEventArgs
DesktopTaskBarItemClickEventArgs
DesktopTaskBarItem
DesktopTaskBarItem
public class DesktopTaskBarItemClickEventArgs : MouseEventArgs

container

IContainer

An IContainer that represents the container of the OpenFileDialog component.

CommonDialog
FileDialog
OpenFileDialog
Public Class OpenFileDialog
    Inherits FileDialog
PromptFileNotFound
CheckFileExists
CreateUI
Form
ShowDialog
DialogTemplate
Form
FileDialog
OnFileOk
IFileSystemProvider
Roots
OpenFileDialog
OpenFileDialog
Boolean
Boolean
String
String[]
FileName
Stream
Stream
ArgumentNullException
FileName
public class OpenFileDialog : FileDialog

path

String

Path of the file or directory.

isDirectory

Boolean

Indicates that the path is for a directory.

FileDialogLoadPathEventHandler

Represents the method that will handle the LoadPath and LoadPath events.

Public Class FileDialogLoadPathEventArgs
    Inherits CancelEventArgs
FileDialog
FolderBrowserDialog
ImageSource
CreationTime
LastWriteTime
FileDialogLoadPathEventArgs
DateTime
Int64
String
Boolean
Path
DateTime
String
public class FileDialogLoadPathEventArgs : CancelEventArgs

fileDialog

FileDialog

IBindableComponent

Bindable components implement this interface.

IContainerControl

Provides the functionality for a control to act as a parent for other controls.

IWisejComponent

All wisej components implement this interface.

IWisejControl

All wisej controls derived from the Control class must implement this interface.

IWisejWindow

All wisej top-level windows implement this interface.

IWisejSerializable

Allows an object to serialize itself.

Control
ScrollableControl
ContainerControl
Form
FileDialogUI
Public Class FileDialogUI
    Inherits Form
public class FileDialogUI : Form
Keys
Keys
PreviewKeyDownEventHandler
PreviewKeyDown
FolderBrowserDialog
IBindableComponent
IContainerControl
IWisejComponent
IWisejControl
Control
IWisejWindow
IWisejSerializable

DataRepeaterItemValueEventArgs

Wisej.Web.DataRepeaterItemValueEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the ItemValueNeeded and ItemValuePushed events.

public class DataRepeaterItemValueEventArgs : EventArgs
Public Class DataRepeaterItemValueEventArgs
    Inherits EventArgs

Constructors

DataRepeaterItemValueEventArgs(itemIndex, control, propertyName, value)

Initializes a new instance of the DataRepeaterItemValueEventArgs class.

Name
Type
Description

itemIndex

The index of the that contains the control that is raising the event.

control

The child control that is raising the event.

propertyName

The property of the control that has changed or that needs data.

value

The property value that has changed.

Properties

Control

Control: Gets the child control of a DataRepeaterItem that is raising the ItemValueNeeded or ItemValuePushed event.

ItemIndex

Int32: Gets the index of the DataRepeaterItem that contains the control that is raising the ItemValueNeeded or ItemValuePushed event.

PropertyName

String: Gets the name of the data-bound property of the control that is raising a ItemValueNeeded or ItemValuePushed event.

Value

Object: Gets the property value that has changed to raise a ItemValueNeeded or ItemValuePushed event.

Used By

Name
Description

Represents the method that will handle the and events.

SplitButton

Wisej.Web.SplitButton

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ButtonBase

      • Button

        • SplitButton

Represents a split button control.

public class SplitButton : Button
Public Class SplitButton
    Inherits Button

Constructors

SplitButton()

Properties

Orientation

Orientation: Returns or sets a value indicating the layout of the SplitButton. When the value is set to Vertical the down arrow is places below the text, otherwise it's to the right of the text.

Implements

Name
Description

Bindable components implement this interface.

Allows a control to act like a button on a .

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

MouseEventHandler

Wisej.Web.MouseEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the MouseDown, MouseUp, or MouseMove event of a form, control, or other component.

public delegate void MouseEventHandler(Object sender, MouseEventArgs e)
Public Delegate Sub MouseEventHandler(ByVal sender As [Object], ByVal e As MouseEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when the control is clicked by the mouse.

Fired when the control is double clicked by the mouse.

Fired when the mouse pointer is over the control and a mouse button is pressed.

Fired when the mouse pointer is moved over the control.

Fired when the mouse pointer is over the control and a mouse button is released.

Fired when the mouse wheel moves while the control has focus.

Fired when the user clicks the control with the mouse.

HashChangedEventHandler

Wisej.Web.HashChangedEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the HashChanged event.

public delegate void HashChangedEventHandler(Object sender, HashChangedEventArgs e)
Public Delegate Sub HashChangedEventHandler(ByVal sender As [Object], ByVal e As HashChangedEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when the hash part of the URL changes on the client side.

Application.FormCollection

Wisej.Web.Application FormCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Holds the collection of all top-level application forms.

public class FormCollection : ICollection, IEnumerable
Public Class FormCollection
    Inherits ICollection
    Implements IEnumerable

Properties

Count

Int32: Returns the total number of currently open forms.

Item(index)

Form: Returns the form at the specified index.

Item(name)

Form: Returns the first form with the specified name, the search is case insensitive.

Methods

GetEnumerator()

Returns an enumerator that iterates through the open forms.

Returns: IEnumerator.

RotateEventHandler

Wisej.Web.RotateEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the Rotate event.

public delegate void RotateEventHandler(Object sender, RotateEventArgs e)
Public Delegate Sub RotateEventHandler(ByVal sender As [Object], ByVal e As RotateEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when two finger moved around a single point. It contains the angle of the rotation.

AcceleratorEventHandler

Wisej.Web.AcceleratorEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the Accelerator event.

public delegate void AcceleratorEventHandler(Object sender, AcceleratorEventArgs e)
Public Delegate Sub AcceleratorEventHandler(ByVal sender As [Object], ByVal e As AcceleratorEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when one of the key is pressed.

KeyPressEventHandler

Wisej.Web.KeyPressEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the KeyPress event of a Control.

public delegate void KeyPressEventHandler(Object sender, KeyPressEventArgs e)
Public Delegate Sub KeyPressEventHandler(ByVal sender As [Object], ByVal e As KeyPressEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

A that contains the event data.

Fired By

Name
Description

Fired when a key is pressed while the control has focus.

RotateEventArgs

Wisej.Web.RotateEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for Rotate event.

public class RotateEventArgs : EventArgs
Public Class RotateEventArgs
    Inherits EventArgs

Properties

Angle

Double: Returns a number with the current calculated angle between the primary and secondary active pointers.

Used By

Name
Description

Represents the method that will handle the event.

DataRepeaterItemEventArgs

Wisej.Web.DataRepeaterItemEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

DataRepeaterItemEventArgs(item)

Initializes a new instance of the class.

Name
Type
Description

Properties

DataRepeaterItem

: Returns a instance that triggered the event.

Used By

Name
Description

SwipeEventHandler

Wisej.Web.SwipeEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event.

Parameters

Name
Type
Description

Fired By

Name
Description

KeyEventHandler

Wisej.Web.KeyEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the or event of a .

Parameters

Name
Type
Description

Fired By

Name
Description

ColorDialog

Wisej.Web.ColorDialog

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents a common dialog box that displays available colors along with controls that enable the user to define custom colors.

Constructors

ColorDialog()

Initializes a new instance of .

ColorDialog(container)

Initializes a new instance of the extender with a specified container.

Name
Type
Description

Properties

Color

: Returns or sets the color selected by the user.

CustomColors

: Returns or sets the set of custom colors shown in the dialog box.

Methods

Reset()

Resets all properties to their default values.

PaintEventHandler

Wisej.Web.PaintEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event of a .

Parameters

Name
Type
Description

Fired By

Name
Description

TrackEventHandler

Wisej.Web.TrackEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event.

Parameters

Name
Type
Description

Fired By

Name
Description

WidgetEventHandler

Wisej.Web.WidgetEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that handles a event.

Parameters

Name
Type
Description

Fired By

Name
Description

LayoutEventHandler

Wisej.Web.LayoutEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the event of a .

Parameters

Name
Type
Description

Fired By

Name
Description
Object
MouseEventArgs
MouseEventArgs
Control.MouseClick
Control.MouseDoubleClick
Control.MouseDown
Control.MouseMove
Control.MouseUp
Control.MouseWheel
CheckedListBox.MouseClick
CheckedListBox
Object
HashChangedEventArgs
HashChangedEventArgs
Application.HashChanged
Object
RotateEventArgs
RotateEventArgs
Control.Rotate
Object
AcceleratorEventArgs
AcceleratorEventArgs
ContainerControl.Accelerator
Accelerators
Object
KeyPressEventArgs
KeyPressEventArgs
Control.KeyPress

sender

Object

The source of the event.

e

SwipeEventArgs

A SwipeEventArgs that contains the event data.

Control.Swipe

Fired when a pointer swipes over the screen.

Swipe
Public Delegate Sub SwipeEventHandler(ByVal sender As [Object], ByVal e As SwipeEventArgs)
public delegate void SwipeEventHandler(Object sender, SwipeEventArgs e)

sender

Object

The source of the event.

e

KeyEventArgs

A KeyEventArgs that contains the event data.

Control.KeyDown

Fired when a key is pressed while the control has focus.

Control.KeyUp

Fired when a key is released while the control has focus.

KeyUp
KeyDown
Control
Public Delegate Sub KeyEventHandler(ByVal sender As [Object], ByVal e As KeyEventArgs)
public delegate void KeyEventHandler(Object sender, KeyEventArgs e)

sender

Object

The source of the event.

e

PaintEventArgs

A PaintEventArgs that contains the event data.

Control.Paint

Fired when a UserPaint control needs to redraw itself.

Paint
Control
Public Delegate Sub PaintEventHandler(ByVal sender As [Object], ByVal e As PaintEventArgs)
public delegate void PaintEventHandler(Object sender, PaintEventArgs e)

sender

Object

The source of the event.

e

TrackEventArgs

A TrackEventArgs that contains the event data.

Control.Track

Fired when a pointer grabs an item and moves the pointer on it.

Track
Public Delegate Sub TrackEventHandler(ByVal sender As [Object], ByVal e As TrackEventArgs)
public delegate void TrackEventHandler(Object sender, TrackEventArgs e)

sender

Object

The source of the event.

e

WidgetEventArgs

A WidgetEventArgs that contains the event data.

Control.WidgetEvent

Fired when the control receives a custom event from the client.

WidgeEvent
Public Delegate Sub WidgetEventHandler(ByVal sender As [Object], ByVal e As WidgetEventArgs)
public delegate void WidgetEventHandler(Object sender, WidgetEventArgs e)

sender

Object

The source of the event.

e

LayoutEventArgs

A LayoutEventArgs that contains the event data.

Control.Layout

Fired when a control should reposition its child controls.

Layout
Control
Public Delegate Sub LayoutEventHandler(ByVal sender As [Object], ByVal e As LayoutEventArgs)
public delegate void LayoutEventHandler(Object sender, LayoutEventArgs e)

item

DataRepeaterItem

The ItemTemplate cloned from the ItemTemplate object.

DataRepeaterItemEventHandler

Represents the method that will handle the ItemCloned event.

ItemCloned
Public Class DataRepeaterItemEventArgs
    Inherits EventArgs
DataRepeaterItemEventArgs
DataRepeaterItem
DataRepeaterItem
public class DataRepeaterItemEventArgs : EventArgs

container

IContainer

An IContainer that represents the container of the ColorDialog component.

CommonDialog
ColorDialog
Public Class ColorDialog
    Inherits CommonDialog
ColorDialog
ColorDialog
Color
Color[]
public class ColorDialog : CommonDialog
Int32
DataRepeaterItem
Control
String
Object
DataRepeaterItemValueEventHandler
ItemValueNeeded
ItemValuePushed
IBindableComponent
IButtonControl
Form
IWisejComponent
IWisejControl
Control
IWisejSerializable
RotateEventHandler
Rotate

SaveFileDialog

Wisej.Web.SaveFileDialog

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • CommonDialog

    • FileDialog

      • SaveFileDialog

Prompts the user to select a location for saving a file on the server.

public class SaveFileDialog : FileDialog
Public Class SaveFileDialog
    Inherits FileDialog

You can:

  • Override PromptFileNotFound. It's called when the specified file doesn't exist and the property CheckFileExists is true.

  • Override PromptFileCreate. It's called when the specified file doesn't exist and the property CreatePrompt is true.

  • Override PromptFileOverwrite. It's called when the specified file doesn't exist and the property OverwritePrompt is true.

  • Override CreateUI to create your custom Form when the method ShowDialog is called.

  • Set the DialogTemplate to a Form class that has a constructor that accepts FileDialog as the single argument to change the User Interface (UI) of the file dialog.

  • Override OnFileOk to provide your custom implementation of the actions to execute when the user presses the OK button.

You must add at least one IFileSystemProvider to the Roots collection before showing the dialog.

Constructors

SaveFileDialog()

Initializes a new instance of SaveFileDialog.

SaveFileDialog(container)

Initializes a new instance of the SaveFileDialog extender with a specified container.

Name
Type
Description

container

An that represents the container of the component.

Properties

CreatePrompt

Boolean: Returns or sets a value indicating whether the dialog box prompts the user for permission to create a file, if the file specified file does not exist.

OverwritePrompt

Boolean: Returns or sets a value indicating whether the dialog box displays a warning if the user specifies a file name that already exists.

Methods

OpenFile()

Opens the file with read/write permission selected by the user.

Returns: Stream. A Stream that specifies the read/write file selected by the user.

Throws:

  • ArgumentNullException FileName is empty or null.

ProcessFileNames(fileNames)

Receives the file names selected by the user and validates them according to the properties set in the FileDialog instance.

Parameter
Type
Description

fileNames

Array containing the selected file paths.

Returns: Boolean. True if the files have been validated and the dialog can close; otherwise false to keep the dialog open.

Reset()

Resets all dialog box options to their default values.

Button

Wisej.Web.Button

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ButtonBase

      • Button

Represents a button control.

public class Button : ButtonBase, IButtonControl
Public Class Button
    Inherits ButtonBase
    Implements IButtonControl

Constructors

Button()

Initializes a new instance of the Button class.

Properties

AutoSizeMode

AutoSizeMode: Returns or sets the mode by which the Button automatically resizes itself.

BorderStyle

BorderStyle: Returns or sets the border style of the button control.

DialogResult

DialogResult: Returns or sets a value that is returned to the parent form when the button is clicked.

Display

Display: Returns or sets the Display mode of the control to determine whether to display the icon, the text or both.

ImageSpacing

Nullable<Int32>: Returns or sets the distance in pixels between the image and the label inside the button.

MenuItems

MenuItemCollection: Returns the collection of MenuItem objects associated with the button.

Repeat

Boolean: Enables or disables the auto-repeat feature. When enabled, the button keeps firing click events at an increasing rate while the user keeps the button pressed.

Shortcut

Shortcut: Returns or sets a value indicating the shortcut key associated with the button.

Methods

PerformClick()

Generates a Click event for a button.

Events

ItemClicked

MenuButtonItemClickedEventHandler Fired when the user clicks one of the drop down menu items.

Inherited By

Name
Description

Represents a split button control.

Implements

Name
Description

Bindable components implement this interface.

Allows a control to act like a button on a .

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

AccordionPanel

Wisej.Web.AccordionPanel

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ScrollableControl

      • Panel

        • AccordionPanel

Represents a panel in a Accordion control.

public class AccordionPanel : Panel
Public Class AccordionPanel
    Inherits Panel

Constructors

AccordionPanel()

Initializes a new instance of the AccordionPanel class.

AccordionPanel(text)

Initializes a new instance of the AccordionPanel class and specifies the text to display as the title of the panel.

Name
Type
Description

text

The text for the tab.

Properties

Accordion

Accordion: Returns the parent Accordion control.

Collapsed

Boolean: Returns whether the AccordionPanel is collapsed.

ShowExpandButton

Boolean: Returns or sets a value indicating that the panel can show the expand button on the title bar.

Text

String: Returns or sets the text to display as the title of the AccordionPanel.

Tools

ComponentToolCollection: Returns the instance of ComponentToolCollection associated with this control.

Methods

GetAccordionPanelOfComponent(control)

Retrieves the panel that contains the specified Control.

Parameter
Type
Description

control

The to look for.

Returns: AccordionPanel. The AccordionPanel that contains the specified Control, or null if it cannot be found.

Update()

Overridden to update the parent Accordion when in design mode.

Implements

Name
Description

Bindable components implement this interface.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

DataRepeaterAddRemoveItemsEventHandler

Wisej.Web.DataRepeaterAddRemoveItemsEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the ItemsAdded, ItemsRemoved, UserAddedItems, and UserDeletedItems events.

public delegate void DataRepeaterAddRemoveItemsEventHandler(Object sender, DataRepeaterAddRemoveItemsEventArgs e)
Public Delegate Sub DataRepeaterAddRemoveItemsEventHandler(ByVal sender As [Object], ByVal e As DataRepeaterAddRemoveItemsEventArgs)

Parameters

Name
Type
Description

sender

The source of the event.

e

An object that contains the event data.

Fired By

Name
Description

Fired when a new is added to the control.

Fired when a is deleted from the control.

Fired when the user adds a new .

Fired after the user deletes a .

QueryContinueDragEventHandler

Wisej.Web.QueryContinueDragEventHandler

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the method that will handle the QueryContinueDrag event of a Control.

public delegate void QueryContinueDragEventHandler(Object sender, QueryContinueDragEventArgs e)
Public Delegate Sub QueryContinueDragEventHandler(ByVal sender As [Object], ByVal e As QueryContinueDragEventArgs)

Parameters

Name
Type
Description

sender

The source of an event.

e

A that contains the event data.

Fired By

Name
Description

Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.

FileDialogRootCollection

Wisej.Web.FileDialogRootCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represent a collection of the IFileSystemProvider root file systems shown by the FileDialog implementation.

public class FileDialogRootCollection : List<>
Public Class FileDialogRootCollection
    Inherits List(Of )

Methods

MapPath(filePath)

Maps the virtual path to the corresponding physical path on the specific IFileSystemProvider implementation.

Parameter
Type
Description

filePath

Virtual path to map to the corresponding physical path.

Returns: String. The physical path for the IFileSystemProvider implementation.

PinchEventArgs

Wisej.Web.PinchEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for Pinch event.

public class PinchEventArgs : EventArgs
Public Class PinchEventArgs
    Inherits EventArgs

Properties

Scale

Double: Returns the calculated scale factor.

Used By

Name
Description

Represents the method that will handle the event.

QueryContinueDragEventArgs

Wisej.Web.QueryContinueDragEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the QueryContinueDrag event.

public class QueryContinueDragEventArgs : EventArgs
Public Class QueryContinueDragEventArgs
    Inherits EventArgs

Constructors

QueryContinueDragEventArgs(args)

Initializes a new instance of the QueryContinueDragEventArgs class.

Name
Type
Description

args

The arguments received from the client.

Properties

Action

DragAction: Returns or sets the status of a drag-and-drop operation.

EscapePressed

Boolean: Returns if the user pressed the ESC key.

KeyState

Int32: Returns the current state of the SHIFT, CTRL, and ALT keys.

Used By

Name
Description

Represents the method that will handle the event of a .

Cursor

Wisej.Web.Cursor

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the mouse pointer.

Constructors

Cursor(image)

Creates a new cursor using the .

Name
Type
Description

Cursor(source)

Creates a new cursor using an image source: can use a themed image or URL.

Name
Type
Description

Cursor(stream)

Creates a new cursor using the .

Name
Type
Description

Cursor(image, x, y)

Creates a new cursor using the .

Name
Type
Description

Cursor(stream, x, y)

Creates a new cursor using the .

Name
Type
Description

Cursor(source, x, y)

Creates a new cursor using an image source: can use a themed image or URL.

Name
Type
Description

Properties

Name

: Returns the name of the cursor.

Position

: Returns or sets the pointer's position.

FolderBrowserDialog

Wisej.Web.FolderBrowserDialog

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Allows the user to select a folder from one of the .

Constructors

FolderBrowserDialog()

Initializes a new instance of .

FolderBrowserDialog(roots)

Initializes a new instance of using the initial roots .

Name
Type
Description

FolderBrowserDialog(container)

Initializes a new instance of the extender with a specified container.

Name
Type
Description

Properties

Description

: Returns or sets the description splayed above the tree view control in the dialog box.

Roots

: List of root file systems displayed by the FolderBrowserDialog.

The Roots collection and the implementations allow the application to use arbitrary names mapped to a specific path. For example, the app may add a root object named "Documents" to "c:\users[logged-user-id]\files\documents". Each user will see "Documents" as the root, but will also see only the files in the [logged-user-id] directory.

SelectedPath

: Returns sets the path selected by the user.

ShowHelp

: Returns or sets whether the Help button is displayed in the file dialog box.

Title

: Returns or sets the file dialog box title.

Methods

GetRoot(path)

Returns the that contains the specified path .

Parameter
Type
Description

Returns: . The that contains the specified path or null if not found.

MapPath(folderPath)

Maps the virtual path to the corresponding physical path on the specific implementation.

Parameter
Type
Description

Returns: . The physical path for the implementation.

Reset()

Resets all properties to their default values.

Events

LoadPath

Fired when the file dialog is loading a file or folder.

ResponsiveProfileChangedEventArgs

Wisej.Web.ResponsiveProfileChangedEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the event.

Constructors

ResponsiveProfileChangedEventArgs(oldValue, newValue)

Initializes a new instance of the class.

Name
Type
Description

Properties

CurrentProfile

: The new active profile.

PreviousProfile

: The previously active profile.

Used By

Name
Description

TouchEventArgs

Wisej.Web.TouchEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for event.

Properties

Identifiers

: Returns the unique identifiers for the touch items.

IsMultiTouch

: Returns whether more than one touch is associated with the event target element.

Locations

: Returns the location of the touch items in screen coordinates.

Rotation

: Returns the delta of the rotation since the start of the event, in degrees.

Scale

: Returns the distance between two fingers since the start of the event.

Used By

Name
Description

AccordionEventArgs

Wisej.Web.AccordionEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the and events of a control.

Constructors

AccordionEventArgs(panel, panelIndex, action)

Initializes a new instance of the class.

Name
Type
Description

Properties

Action

: Returns a value indicating which event is occurring.

Panel

: Returns the the event is occurring for.

PanelIndex

: Returns the zero-based index of the in the collection.

Used By

Name
Description
Object
DataRepeaterAddRemoveItemsEventArgs
DataRepeater.ItemsAdded
DataRepeaterItem
DataRepeater
DataRepeater.ItemsRemoved
DataRepeaterItem
DataRepeater
DataRepeater.UserAddedItems
DataRepeaterItem
DataRepeater.UserDeletedItems
DataRepeaterItem
Object
QueryContinueDragEventArgs
QueryContinueDragEventArgs
Control.QueryContinueDrag
Logo

image

Image

An Image to use for the cursor.

source

String

The name of a theme image or a URL to an image resource.

stream

Stream

A Stream to use for the cursor.

image

Image

An Image to use for the cursor.

x

Int32

x-coordinate of the hotspot location.

y

Int32

y-coordinate of the hotspot location.

stream

Stream

A Stream to use for the cursor.

x

Int32

x-coordinate of the hotspot location.

y

Int32

y-coordinate of the hotspot location.

source

String

The name of a theme image or a URL to an image resource.

x

Int32

x-coordinate of the hotspot location.

y

Int32

y-coordinate of the hotspot location.

Public Class Cursor
Image
Image
Image
Image
String
Point
public class Cursor

roots

IFileSystemProvider[]

Initial file systems to load in the FolderBrowserDialog.

container

IContainer

An IContainer that represents the container of the FolderBrowserDialog component.

path

String

Full path of the file to locate in on of the Roots.

folderPath

String

Virtual path to map to the corresponding physical path.

CommonDialog
FolderBrowserDialog
Roots
Public Class FolderBrowserDialog
    Inherits CommonDialog
FolderBrowserDialog
FolderBrowserDialog
FolderBrowserDialog
String
FileDialogRootCollection
IFileSystemProvider
IFileSystemProvider
String
Boolean
String
IFileSystemProvider
IFileSystemProvider
IFileSystemProvider
IFileSystemProvider
String
IFileSystemProvider
FileDialogLoadPathEventHandler
public class FolderBrowserDialog : CommonDialog

oldValue

ClientProfile

Previous ClientProfile.

newValue

ClientProfile

New active ClientProfile.

ResponsiveProfileChangedEventHandler

Represents the method that will handle the Application.ResponsiveProfileChanged event.

ResponsiveProfileChanged
Public Class ResponsiveProfileChangedEventArgs
    Inherits EventArgs
ResponsiveProfileChangedEventArgs
ClientProfile
ClientProfile
public class ResponsiveProfileChangedEventArgs : EventArgs

TouchEventHandler

Represents the method that will handle the TouchStart, TouchEnd, TouchMove, TouchCancel events.

Swipe
Public Class TouchEventArgs
    Inherits EventArgs
Int64[]
Boolean
Point[]
Double
Double
public class TouchEventArgs : EventArgs

panel

AccordionPanel

The AccordionPanel the event is occurring for.

panelIndex

Int32

The zero-based index of panel in the Panels collection.

action

AccordionAction

One of the AccordionAction values.

AccordionEventHandler

Represents the method that will handle the Selected or Deselected event of a Accordion control.

Selected
Deselected
Accordion
Public Class AccordionEventArgs
    Inherits EventArgs
AccordionEventArgs
AccordionAction
AccordionPanel
AccordionPanel
Int32
Panel
Panels
public class AccordionEventArgs : EventArgs
IContainer
IContainer
SaveFileDialog
String[]
SplitButton
IBindableComponent
IButtonControl
Form
IWisejComponent
IWisejControl
Control
IWisejSerializable
String
Control
Control
IBindableComponent
IWisejComponent
IWisejControl
Control
IWisejSerializable
String
PinchEventHandler
Pinch
WisejEventArgs
QueryContinueDragEventHandler
QueryContinueDrag
Control

CheckBox

Wisej.Web.CheckBox

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ButtonBase

      • CheckBox

Represents a check box control.

public class CheckBox : ButtonBase
Public Class CheckBox
    Inherits ButtonBase

Constructors

CheckBox()

Initializes a new instance of the CheckBox class.

Properties

Appearance

Appearance: Returns or sets the value that determines the appearance of a CheckBox control.

AutoCheck

Boolean: Returns or set a value indicating whether the Checked or CheckState values and the CheckBox's appearance are automatically changed when the CheckBox is clicked.

AutoSize

Boolean: Returns or sets a value that indicates whether the control resizes based on its contents.

CheckAlign

ContentAlignment: Returns or sets the horizontal and vertical alignment of the check mark on a CheckBox control.

Checked

Boolean: Returns or set a value indicating whether the CheckBox is in the checked state.

CheckedForeColor

Color: Returns or sets the text color used when the CheckBox is checked.

CheckState

CheckState: Returns or sets the state of the CheckBox.

Invalid

Boolean: Returns or sets a value that indicates that the control is invalid.

InvalidMessage

String: Returns or sets the invalid message that is shown in the invalid tooltip.

ReadOnly

Boolean: Returns or sets whether the control is read-only.

TextAlign

ContentAlignment: Returns or sets the alignment of the text on the CheckBox control.

ThreeState

Boolean: Returns or sets whether the CheckBox will allow three check states rather than two.

Methods

PerformClick()

Generates a Click event for a CheckBox.

Events

AppearanceChanged

EventHandler Fired when the value of the Appearance property changes.

CheckedChanged

EventHandler Fired when the value of the Checked property changes.

CheckStateChanged

EventHandler Fired when the value of the CheckState property changes.

ReadOnlyChanged

EventHandler Fired when the value of the ReadOnly property has changed.

Implements

Name
Description

Bindable components implement this interface.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

RadioButton

Wisej.Web.RadioButton

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ButtonBase

      • RadioButton

Enables the user to select a single option from a group of choices when paired with other RadioButton controls.

public class RadioButton : ButtonBase
Public Class RadioButton
    Inherits ButtonBase

Constructors

RadioButton()

Initializes a new instance of the RadioButton class.

Properties

Appearance

Appearance: Returns or sets the value that determines the appearance of a CheckBox control.

AutoCheck

Boolean: Returns or set a value indicating whether the Checked or CheckState values and the CheckBox's appearance are automatically changed when the CheckBox is clicked.

AutoSize

Boolean: Returns or sets a value that indicates whether the control resizes based on its contents.

CheckAlign

ContentAlignment: Returns or sets the horizontal and vertical alignment of the check mark on a CheckBox control.

Checked

Boolean: Gets or sets whether the control is checked.

CheckedForeColor

Color: Returns or sets the text color used when the RadioButton is checked.

Invalid

Boolean: Returns or sets a value that indicates that the control is invalid.

InvalidMessage

String: Returns or sets the invalid message that is shown in the invalid tooltip.

ReadOnly

Boolean: Returns or sets whether the control is read-only.

TabStop

Boolean: Returns or sets whether the user can give the focus to this control using the TAB key and the Focusable property is set to true.

TextAlign

ContentAlignment: Returns or sets the alignment of the text on the CheckBox control.

Methods

PerformClick()

Generates a Click event for a RadioButton.

Events

AppearanceChanged

EventHandler Fired when the value of the Appearance property changes.

CheckedChanged

EventHandler Fired when the value of the Checked property changes.

ReadOnlyChanged

EventHandler Fired when the value of the ReadOnly property has changed.

Implements

Name
Description

Bindable components implement this interface.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

WidgetEventArgs

Wisej.Web.WidgetEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the WidgetEvent event of the Widget control.

public class WidgetEventArgs : EventArgs
Public Class WidgetEventArgs
    Inherits EventArgs

Constructors

WidgetEventArgs(type, data)

Initializes a new instance of the WidgetEventArgs class.

Name
Type
Description

type

The type (name) of event.

data

The data object received with the event.

Properties

Data

Object: Returns the data object that was sent by the widget with the event.

Type

String: Returns the type (name) of the event fired by the widget.

Used By

Name
Description

Represents the method that handles a event.

IBindableComponent
IWisejComponent
IWisejControl
Control
IWisejSerializable
IBindableComponent
IWisejComponent
IWisejControl
Control
IWisejSerializable
String
Object
WidgetEventHandler
WidgeEvent

Control.ControlCollection

Wisej.Web.Control ControlCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents a collection of Control objects.

public class ControlCollection : ControlCollection, IList<Control>, ICollection<Control>, IEnumerable<Control>, IWisejSynchronized
Public Class ControlCollection
    Inherits ControlCollection
    Implements IList(Of Control), ICollection(Of Control), IEnumerable(Of Control), IWisejSynchronized

Constructors

ControlCollection(owner)

Initializes a new instance of the ControlCollection class.

Name
Type
Description

owner

The that owns this collection.

Properties

IsDisposed

Boolean: Returns whether the owner control has already been disposed.

Item(index)

Control: Returns the Control at the specified indexed location.

Item(key)

Control: Returns the Control with the specified key in the collection.

Owner

Control: Returns the control that owns this ControlCollection.

Methods

Add(child)

Adds the specified control to the control collection.

Parameter
Type
Description

child

The to add.

AddRange(controls)

Adds an array of control objects to the collection.

Parameter
Type
Description

controls

An array of objects to add to the collection.

Clear()

Removes all controls from the collection.

Clear(dispose)

Removes and disposes all controls from the collection.

Parameter
Type
Description

dispose

Indicates whether the controls removed from the collection should be disposed.

Contains(control)

Determines whether the specified control is a member of the collection.

Parameter
Type
Description

control

The to locate in the collection.

Returns: Boolean. true if the Control is a member of the collection; otherwise, false.

ContainsKey(key)

Determines whether the ControlCollection contains an item with the specified key.

Parameter
Type
Description

key

The key to locate in the .

Returns: Boolean. true if the ControlCollection contains an item with the specified key; otherwise, false.

Find(type, searchAllChildren)

Searches for controls by their type and builds an array of all the controls that match.

Parameter
Type
Description

type

The type of the controls to locate in the .

searchAllChildren

true to search all child controls; otherwise, false.

Returns: Control[]. Array of controls that are derived from the specified type .

Throws:

  • ArgumentNullException type is null.

Find(key, searchAllChildren)

Searches for controls by their name and builds an array of all the controls that match.

Parameter
Type
Description

key

The key to located in the .

searchAllChildren

true to search all child controls; otherwise, false.

Returns: Control[]. Array of controls with the specified name.

Throws:

  • ArgumentNullException The key parameter is null or an empty string ("").

GetChildIndex(child, throwException)

Retrieves the index of the specified child control within the control collection, and optionally raises an exception if the specified control is not within the control collection.

Parameter
Type
Description

child

The to search for in the control collection.

throwException

true to throw an exception if the specified in the child parameter is not a control in the ; otherwise, false.

Returns: Int32. A zero-based index value that represents the location of the specified child control within the control collection; otherwise -1 if the specified Control is not found in the ControlCollection.

Throws:

  • ArgumentException The child Control is not in the ControlCollection, and the throwException parameter value is true.

GetEnumerator()

Retrieves a reference to an enumerator object that is used to iterate over a ControlCollection.

Returns: IEnumerator. An IEnumerator.

IndexOf(control)

Retrieves the index of the specified control in the control collection.

Parameter
Type
Description

control

The to locate in the collection.

Returns: Int32. A zero-based index value that represents the position of the specified Control in the ControlCollection.

IndexOfKey(key)

Retrieves the index of the first occurrence of the specified item within the collection.

Parameter
Type
Description

key

The name of the control to search for.

Returns: Int32. The zero-based index of the first occurrence of the control with the specified name in the collection.

Remove(child)

Removes the specified control from the control collection.

Parameter
Type
Description

child

The to remove.

RemoveByKey(key)

Removes the child control with the specified key.

Parameter
Type
Description

key

The name of the child control to remove.

SetChildIndex(child, newIndex)

Sets the index of the specified child control in the collection.

Parameter
Type
Description

child

The child control to search for.

newIndex

The new index value of the control.

Desktop

Wisej.Web.Desktop

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ScrollableControl

      • ContainerControl

        • Desktop

Represents a desktop container that can host floating windows.

public class Desktop : ContainerControl, IWisejWindow, IWisejDesignTarget
Public Class Desktop
    Inherits ContainerControl
    Implements IWisejWindow, IWisejDesignTarget

Constructors

Desktop()

Initializes a new instance of the Desktop class.

Properties

Active

Boolean: Returns true if this desktop instance is the currently active desktop. It is the same as comparing the instance with Desktop.

AutoHideTaskbar

Boolean: Returns or sets whether the taskbar is hidden automatically when there are no opened windows or no windows with the property ShowInTaskbar set to true.

DisplayRectangle

Rectangle: Returns a rectangle that represents the inner dimensions of the Desktop control.

Dock

DockStyle: Returns or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

Height

Int32: Returns or sets the height of the page.

IsTaskbarVisible

Boolean: Returns whether the taskbar is currently visible.

Items

DesktopTaskBarItemCollection: Returns the collection of DesktopTaskBarItem controls displayed in the taskbar of the desktop control.

Location

Point: Returns or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.

Size

Size: Returns the height and width of the page.

TaskbarPosition

Position: Return or sets the position of the taskbar to one of the four sides indicated by the Position values.

TaskbarSize

Int32: Returns the height or width of the taskbar in the current theme, depending on the value of TaskbarPosition.

Text

String: Returns or sets the title of the Desktop. If the desktop is the main desktop, setting the text also changes the title in the browser.

Wallpaper

String: Returns or sets the wallpaper image.

Width

Int32: Returns or sets the width of the page.

Events

Activated

EventHandler Fired when the desktop becomes active, and it's the new Desktop.

Deactivate

EventHandler Fired when the desktop is deactivated and it's no longer the Desktop.

ItemClick

DesktopTaskBarItemClickEventHandler Fired when a DesktopTaskBarItem on the Desktop is clicked.

ItemDoubleClick

DesktopTaskBarItemClickEventHandler Fired when a DesktopTaskBarItem on the Desktop is double clicked.

Load

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

TaskbarPositionChanged

EventHandler Occurs when the property TaskbarPosition changes value.

TaskbarVisibleChanged

EventHandler Occurs when the property AutoHideTaskbar is set to true and the TaskBar is either hidden or shown.

Implements

Name
Description

Bindable components implement this interface.

Provides the functionality for a control to act as a parent for other controls.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

All wisej top-level windows implement this interface.

Allows an object to serialize itself.

DataRepeaterItem

Wisej.Web.DataRepeaterItem

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ScrollableControl

      • Panel

        • DataRepeaterItem

Used by the DataRepeater control to display data at run time.

public class DataRepeaterItem : Panel
Public Class DataRepeaterItem
    Inherits Panel

Constructors

DataRepeaterItem()

Initializes a new instance of the DataRepeaterItem object.

Properties

IsCurrent

Boolean: Return a value that determines whether a DataRepeaterItem is the currently selected item in a DataRepeater control.

ItemIndex

Int32: Returns the index of a DataRepeaterItem in a DataRepeater control.

Modified

Boolean: Returns value that determines whether the data for a DataRepeaterItem in a DataRepeater control has been changed by the user.

Implements

Name
Description

Bindable components implement this interface.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

Control
Control
Control
Control
Control[]
Control
Boolean
Control
Control
String
ControlCollection
Type
ControlCollection
Boolean
String
ControlCollection
Boolean
Control
Control
Boolean
Control
ControlCollection
Control
Control
String
Control
Control
String
Control
Int32
IBindableComponent
IContainerControl
IWisejComponent
IWisejControl
Control
IWisejWindow
IWisejSerializable
IBindableComponent
IWisejComponent
IWisejControl
Control
IWisejSerializable

Padding

Wisej.Web.Padding

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents padding or margin information associated with a user interface (UI) element.

public struct Padding : ValueType, IWisejSerializable
Public Structure Padding
    Implements ValueType, IWisejSerializable

Constructors

Padding(left, top, right, bottom)

Initializes a new instance of the Padding class using a separate padding size for each edge.

Name
Type
Description

left

The padding size, in pixels, for the left edge.

top

The padding size, in pixels, for the top edge.

right

The padding size, in pixels, for the right edge.

bottom

The padding size, in pixels, for the bottom edge.

Padding(all)

Initializes a new instance of the Padding class using the supplied padding size for all edges.

Name
Type
Description

all

The number of pixels to be used for padding for all edges.

Properties

All

Int32: Returns or sets the padding value for all the edges.

Bottom

Int32: Returns or sets the padding value for the bottom edge.

Horizontal

Int32: Returns the combined padding for the right and left edges.

IsEmpty

Boolean: Returns if the padding is empty.

Left

Int32: Returns or sets the padding value for the left edge.

Right

Int32: Returns or sets the padding value for the right edge.

Size

Size: Returns the padding information in the form of a Size.

Top

Int32: Returns or sets the padding value for the top edge.

Vertical

Int32: Returns the combined padding for the top and bottom edges.

Methods

Add(p1, p2)

Computes the sum of the two specified Padding values.

Parameter
Type
Description

p1

A .

p2

A .

Returns: Padding. A Padding that contains the sum of the two specified Padding values.

Subtract(p1, p2)

Subtracts one specified Padding value from another.

Parameter
Type
Description

p1

A .

p2

A .

Returns: Padding. A Padding that contains the result of the subtraction of one specified Padding value from another.

Used By

Name
Description

Returns or sets padding within the control.

Returns or sets the space between controls.

Returns or sets the additional padding around the label. This property can be defined in the theme.

Returns or sets the space between the edge of a and its content.

Returns or sets the offset in pixels from the calculated position of the popup.

Returns or sets the padding inside objects in any mode.

Returns or sets padding within the toolbar button.

Returns or sets the space between toolbar buttons.

Computes the sum of the two specified values.

Returns the size of the inset border and padding.

ContainerControl

Wisej.Web.ContainerControl

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ScrollableControl

      • ContainerControl

Provides focus-management functionality for controls that can function as a container for other controls.

public class ContainerControl : ScrollableControl, IContainerControl, IContainerControl
Public Class ContainerControl
    Inherits ScrollableControl
    Implements IContainerControl, IContainerControl

Constructors

ContainerControl()

Initializes a new instance of the ContainerControl class.

Properties

Accelerators

Keys[]: Returns or sets a collection of keys that fire the Accelerator event when the user presses the accelerator key while the focus is on any child control.

ActiveControl

Control: Returns or sets the active control on the container control.

Throws:

  • ArgumentException The Control assigned could not be activated.

BindingContext

BindingContext: Returns or sets the BindingContext for the control.

KeyPreview

Boolean: Returns or sets whether the container will receive key events before the event is passed to the control that has focus.

ParentForm

Form: Returns the Form that the container control is assigned to.

ParentPage

Page: Returns the Page that the container control is assigned to.

RightToLeftLayout

Boolean: Enables or disables right-to-left layout when the value of RightToLeft is Yes

Methods

Validate()

Validates the last unvalidated control and its ancestors up through, but not including the current control.

Returns: Boolean.

Validate(checkAutoValidate)

Validates the last unvalidated control and its ancestors up through, but not including the current control.

Parameter
Type
Description

checkAutoValidate

If true, the value of the property is used to determine if validation should be performed; if false, validation is unconditionally performed.

Returns: Boolean.

Events

Accelerator

AcceleratorEventHandler Fired when one of the Accelerators key is pressed.

RightToLeftLayoutChanged

EventHandler Fired when the value of the RightToLeftLayout property changes.

Inherited By

Name
Description

UI implementation for the FileDialog class.

UI implementation for the FolderDialog class.

Displays data in a customizable list format.

Represents a window or dialog box that makes up an application's user interface.

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.

Represents a control consisting of a movable bar that divides a container's display area into two resizable panels.

Provides an empty control that can be used to create other controls.

Represents a desktop container that can host floating windows.

Provides an popup container that can be attached to other controls.

Implements

Name
Description

Bindable components implement this interface.

Provides the functionality for a control to act as a parent for other controls.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

DragEventArgs

Wisej.Web.DragEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the DragDrop, DragEnter, or DragOver event.

public class DragEventArgs : EventArgs
Public Class DragEventArgs
    Inherits EventArgs

Constructors

DragEventArgs(allowedEffect, effect, data, location)

Initializes a new instance of the DragEventArgs class.

Name
Type
Description

allowedEffect

One of the values.

effect

One of the values.

data

The data associated with this event.

location

The that indicates the location of the drag event.

Properties

AllowedEffect

DragDropEffects: Returns which drag-and-drop operations are allowed by the originator (or source) of the drag event.

AllowedFileTypes

String: Specify the types of files that the server accepts (that can be submitted through a file upload).

The allowed files string follows the HTML 4.01 and HTML5 specifications. You can configure only one entry in the browser's file dialog. The syntax is "file_extension|audio/|video/|image/*|media_type". Look at IANA Media Types for a complete list of standard media types.

Data

IDataObject: Returns the IDataObject that contains the data associated with this event.

DropTarget

Object: Returns the original target of the drag operation.

Effect

DragDropEffects: Returns or sets the target drop effect in a drag-and-drop operation.

Image

Image: Returns or sets the custom image displayed on the client to represent the drag action.

ImageSize

Size: Returns or sets the size in pixels of the custom image displayed on the client to represent the drag action.

ImageSource

String: Returns or sets the custom image source displayed on the client to represent the drag action.

KeyState

Int32: Returns the current state of the SHIFT, CTRL, and ALT keys, as well as the state of the mouse buttons.

Location

Point: Returns the location of the mouse or pointer event, in screen coordinates.

X

Int32: Returns the x-coordinate of the mouse or pointer, in screen coordinates.

Y

Int32: Returns the y-coordinate of the mouse or pointer, in screen coordinates.

Used By

Name
Description

Represents the method that will handle the , , or event of a .

DesktopTaskBarItem

Wisej.Web.DesktopTaskBarItem

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents a component in the control's taskbar.

Constructors

DesktopTaskBarItem()

Initializes a new instance of the class.

DesktopTaskBarItem(text)

Initializes a new instance of the class and displays the specified text on the item.

Name
Type
Description

Properties

AllowHtml

: Returns or sets a value indicating that the control can display html in the Text property.

Enabled

: Returns or sets whether the button is enabled.

Image

: Returns or sets the image that is displayed in a .

ImagePosition

: Returns or sets the position of the within this taskbar item.

ImageSource

: Returns or sets the theme name or URL for the image to display in the .

Name

: Returns or sets the name of the .

Parent

: Returns the control that the taskbar item button is assigned to.

Position

: Returns or sets the position of this within the taskbar in the parent .

Tag

: Returns or sets the object that contains user data.

Text

: Returns or sets the text displayed on the taskbar item.

When AllowHtml is set to true, the text can contain HTML content. If the text contains new lines (CRLF) but doesn't contain HTML elements (at least one "<") all CRLF are automatically substituted with " ".

ToolTipText

: Returns or sets the text that appears as a ToolTip for the taskbar item.

Visible

: Returns or sets whether the taskbar item is visible or hidden.

Methods

Update()

Updates the component on the client. Overridden to repaint the taskbar in design mode.

Inherited By

Name
Description

Implements

Name
Description

Cursors

Wisej.Web.Cursors

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Defines a collection of predefined objects.

Properties

Alias

: Returns the "shortcut" cursor.

Arrow

: Returns the "arrow" cursor.

Cell

: Returns "cell" cursor.

Copy

: Returns the clipboard "copy" cursor.

Cross

: Returns the "crosshair" cursor.

Default

: Returns the "default" cursor, which is usually an arrow cursor.

Grab

: Returns the "grab" cursor.

Hand

: Returns the "hand" cursor, typically used when hovering over a Web link.

Help

: Returns the "help" cursor, which is a combination of an arrow and a question mark.

HSplit

: Returns the "row-resize" cursor that appears when the mouse is positioned over a horizontal splitter bar.

IBeam

: Returns the "text" cursor, which is used to show where the text cursor appears when the mouse is clicked.

Move

: Returns the "move" cursor, typically an cross shape.

No

: Returns the "not-allowed" cursor that indicates that a particular region is invalid for the current operation.

None

: Returns the "none" cursor.

NotAllowed

: Returns the "not-allowed" cursor.

SizeAll

: Returns the "move" sizing cursor, which consists of four joined arrows that point north, south, east, and west.

SizeNE

: Returns the "ne-resize" diagonal (north/east) sizing cursor.

SizeNESW

: Returns the "nesw-resize" diagonal (northeast/southwest) sizing cursor.

SizeNS

: Returns the "n-resize" vertical (north/south) sizing cursor.

SizeNW

: Returns the "nw-resize" diagonal (north/west) sizing cursor.

SizeNWSE

: Returns the "nwse-resize" diagonal (northwest/southeast) sizing cursor.

SizeSE

: Returns the "se-resize" diagonal (south/east) sizing cursor.

SizeSW

: Returns the "sw-resize" diagonal (south/west) sizing cursor.

SizeWE

: Returns the "w-resize" horizontal (west/east) sizing cursor.

Text

: Returns the "text" cursor.

VSplit

: Returns the "col-resize" cursor that appears when the mouse is positioned over a vertical splitter bar.

WaitCursor

: Returns the "wait" cursor, typically an hourglass shape.

ZoomIn

: Returns the "zoom-in" cursor.

ZoomOut

: Returns the "zoom-out" cursor.

ButtonBase

Wisej.Web.ButtonBase

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Implements the basic functionality common to button controls.

Constructors

ButtonBase()

Initializes a new instance of the class.

Properties

AllowHtml

: Returns or sets a value indicating that the control can display HTML in the Text property.

Newlines (CRLF) are converted to when allowHtml is false, or when allowHtml is true and the text doesn't contain any html.

AutoEllipsis

: Returns or sets whether the ellipsis character (...) appears at the right edge of the control, denoting that the text extends beyond the size of the control.

AutoShowLoader

: Returns or sets whether the application blocks the browser with a modal mask when this button is clicked and until the server is done processing the execution request.

blocks the entire browser as soon as the button is clicked since it's implemented on the client side, while blocks the specific widget when returning from the request.

AutoSize

: Returns or sets a value that indicates whether the control resizes based on its contents.

Image

: Returns or sets the image that is displayed in a button control.

ImageAlign

: Returns or sets the alignment of the image in the button control.

ImageIndex

: Returns or sets the image list index value of the image in the displayed in the button control.

Throws:

  • The specified index is less than -1.

ImageKey

: Returns or sets the key accessor for the image in the displayed in the button control.

ImageList

: Returns or sets the that contains the displayed in a button control.

ImageSource

: Returns or sets the theme name or URL for the image to display in the button control.

Text

: Returns or sets the text associated with this control.

Newlines (CRLF) are converted to when allowHtml is false, or when allowHtml is true and the text doesn't contain any html.

TextAlign

: Returns or sets the alignment of the text in the button control.

TextImageRelation

: Returns or sets the position of text and image relative to each other.

UseMnemonic

: Returns or sets whether the first character that is preceded by an ampersand (&) is used as the mnemonic key of the control.

Methods

PerformClick()

Generates a event for a button.

Inherited By

Name
Description

Implements

Name
Description

text

String

The text to display on the new DesktopTaskBarItem.

DesktopTaskBarItemControl

Represents a component in the Desktop control's taskbar that can host any Control.

DesktopTaskBarItemDateTime

Represents a DateTime component in the Desktop control's taskbar.

IWisejComponent

All wisej components implement this interface.

IWisejSerializable

Allows an object to serialize itself.

Component
Component
DesktopTaskBarItem
Desktop
Public Class DesktopTaskBarItem
    Inherits Component
DesktopTaskBarItem
DesktopTaskBarItem
Boolean
Boolean
Image
DesktopTaskBarItem
ImagePosition
Image
String
DesktopTaskBarItem
String
DesktopTaskBarItem
Desktop
Desktop
LeftRightAlignment
DesktopTaskBarItem
Desktop
Object
String
String
Boolean
public class DesktopTaskBarItem : Component

Button

Represents a button control.

CheckBox

Represents a check box control.

RadioButton

Enables the user to select a single option from a group of choices when paired with other RadioButton controls.

SplitButton

Represents a split button control.

IBindableComponent

Bindable components implement this interface.

IWisejComponent

All wisej components implement this interface.

IWisejControl

All wisej controls derived from the Control class must implement this interface.

IWisejSerializable

Allows an object to serialize itself.

Control
ButtonBase
Public Class ButtonBase
    Inherits Control
ButtonBase
Boolean
Boolean
Boolean
AutoShowLoader
ShowLoader
Boolean
Image
ContentAlignment
Int32
ImageList
ArgumentOutOfRangeException
String
ImageList
ImageList
ImageList
Image
String
String
ContentAlignment
TextImageRelation
Boolean
Click
public class ButtonBase : Control
Int32
Int32
Int32
Int32
Int32
Padding
Padding
Padding
Padding
Padding
Padding
Padding
Padding
Control.Padding
Control.Margin
LabelWrapper.Padding
DataGridViewCellStyle.Padding
DataGridViewCell
UserPopup.Offset
ListView.ItemPadding
ListViewItem
View
ToolBarButton.Padding
ToolBarButton.Margin
Padding.Add
Padding
ClientTheme.GetInsets
Boolean
AutoValidate
FileDialogUI
FolderBrowserDialogUI
DataRepeater
Form
Page
SplitContainer
UserControl
Desktop
UserPopup
IBindableComponent
IContainerControl
IWisejComponent
IWisejControl
Control
IWisejSerializable
DragDropEffects
DragDropEffects
DragDropEffects
DragDropEffects
Object
Point
Point
DragEventHandler
DragDrop
DragEnter
DragOver
Control
Cursor
Public Class Cursors
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
Cursor
public class Cursors

MouseEventArgs

Wisej.Web.MouseEventArgs

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides data for the MouseUp, MouseDown, and MouseMove events.

public class MouseEventArgs : EventArgs
Public Class MouseEventArgs
    Inherits EventArgs

Constructors

MouseEventArgs(button, clicks, x, y, delta)

Initializes a new instance of the MouseEventArgs class.

Name
Type
Description

button

One of the values that indicate which mouse button was pressed.

clicks

The number of times a mouse button was pressed.

x

The x-coordinate of a pointer click, in pixels.

y

The y-coordinate of a pointer click, in pixels.

delta

A signed count of the number of dents the wheel has rotated.

MouseEventArgs(button, clicks, x, y, delta, role)

Initializes a new instance of the MouseEventArgs class.

Name
Type
Description

button

One of the values that indicate which mouse button was pressed.

clicks

The number of times a mouse button was pressed.

x

The x-coordinate of a pointer click, in pixels.

y

The y-coordinate of a pointer click, in pixels.

delta

A signed count of the number of dents the wheel has rotated.

role

The internal role assigned to the element that generated the pointer event.

Properties

Button

MouseButtons: Returns which mouse button was pressed.

Clicks

Int32: Returns the number of clicks or taps.

Delta

Int32: Returns the number of times the mouse wheel has rotated.

Location

Point: Returns the location of the mouse or pointer event.

OriginalTarget

Control: Returns the original target Control when the pointer event has bubbled up because the original target was either not Enabled or Anonymous.

Role

String: Returns the internal role assigned to the element that generated the pointer event: checkbox, button, ...

The value in the Role property is taken from the "role" attribute of the clicked element inside the widget. You can detect clicks on custom HTML content by adding the role attribute to the custom element.

X

Int32: Returns the x-coordinate of the mouse or touch event.

Y

Int32: Returns the y-coordinate of the mouse or touch event.

Used By

Name
Description

Represents the method that will handle the MouseDown, MouseUp, or MouseMove event of a form, control, or other component.

MouseButtons
MouseButtons
Int32
Int32
Int32
Int32
MouseButtons
MouseButtons
Int32
Int32
Int32
Int32
String
MouseEventHandler

Component

Wisej.Web.Component

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Component

    • Component

Extends Component and enabled the components to appear on the designer surface.

public class Component : Component, IComponent
Public Class Component
    Inherits Component
    Implements IComponent

Constructors

Component()

Default constructor

Methods

Update()

Updates the component on the client.

Inherited By

Name
Description

Represents a panel in a control. Although the control replaces and adds functionality to the control of previous versions, is retained for both backward compatibility and future use if you choose.

Implements a timer that raises an event at user-defined intervals.

Represents a component in the control's taskbar.

Represents a component in the control's taskbar that can host any .

Represents a DateTime component in the control's taskbar.

Provides support for animating controls or windows using predefined animations definitions or custom animations in response to certain events.

Provides a user interface for indicating that a control on a form has an error associated with it.

Represents a small rectangular pop-up window that displays a brief help text next to a control when it gets activated (focused).

Allows controls to execute javascript code.

Add rotation capabilities along the X,Y,Z axis to controls.

Adds CSS styling to controls.

Represents a small rectangular pop-up window that displays a brief description of a control's purpose when the user rests the pointer on the control.

Provides methods to manage a collection of objects. This class cannot be inherited.

Displays a standard column header in a control.

Displays an image column header in a control.

Represents a context menu associated to a .

Represents an individual menu item that is displayed within a or rendered using the link element to let the browser process the specified URL.

Represents the main menu in a .

Represents the base functionality for all menus.

Represents an individual item that is displayed within a or .

Represents a button in the .

Implements

Name
Description

All wisej components implement this interface.

Allows an object to serialize itself.

StatusBarPanel
StatusBar
StatusStrip
StatusBar
StatusBar
Timer
DesktopTaskBarItem
Desktop
DesktopTaskBarItemControl
Desktop
Control
DesktopTaskBarItemDateTime
Desktop
Animation
ErrorProvider
HelpTip
JavaScript
Rotation
Control
StyleSheet
ToolTip
ImageList
Image
ColumnHeader
ListView
ImageColumnHeader
ListView
ContextMenu
Control
LinkMenuItem
MainMenu
ContextMenu
HRef
MainMenu
Form
Menu
MenuItem
MainMenu
ContextMenu
ToolBarButton
ToolBar
IWisejComponent
IWisejSerializable

Accordion

Wisej.Web.Accordion

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • Accordion

Displays collapsible set of AccordionPanel panels for presenting information in a limited amount of space.

public class Accordion : Control, ISupportInitialize
Public Class Accordion
    Inherits Control
    Implements ISupportInitialize

Constructors

Accordion()

Initializes a new instance of the Accordion class.

Properties

BorderStyle

BorderStyle: Returns or sets the type of border that is drawn around the Accordion panel.

Collapsible

Boolean: Returns or sets a value indicating whether the Accordion control collapses when all the AccordionPanel children are collapsed.

When this property is set to false (default) one panel is always expanded.

DisplayRectangle

Rectangle: Returns the rectangle that represents the virtual display area of the control.

ImageList

ImageList: Returns or sets the images to display on the panel's title bar.

PanelCount

Int32: Returns the number of panels in the container.

Panels

PanelCollection: Returns the collection of panels in the container.

SelectedIndex

Int32: Returns or sets the index of the currently selected panel.

Throws:

  • ArgumentOutOfRangeException The value is less than -1.

SelectedOnTop

Boolean: Returns or sets a value indicating whether the selected panel is moved to the top of the Accordion container.

SelectedPanel

AccordionPanel: Returns or sets the currently selected panel.

ShowToolTips

Boolean: Returns or sets whether a panel's ToolTip is shown when the mouse passes over the panel's title.

Methods

DeselectPanel(index)

Makes the AccordionPanel following the AccordionPanel with the specified index the current panel.

Parameter
Type
Description

index

The index in the collection of the to deselect.

Throws:

  • ArgumentOutOfRangeException index is less than 0 or greater than the number of AccordionPanel controls in the Panels collection minus 1.

DeselectPanel(panel)

Makes the AccordionPanel following the specified AccordionPanel the current panel.

Parameter
Type
Description

panel

The to deselect.

Throws:

  • ArgumentNullException panel is null.

DeselectPanel(panelName)

Makes the AccordionPanel following the AccordionPanel the specified name the current panel.

Parameter
Type
Description

panelName

The of the panel to deselect.

Throws:

  • ArgumentNullException panelName is null; or panelName does not match the Name property of any AccordionPanel in the Panels collection.

GetControl(index)

Returns the AccordionPanel panel at the specified location.

Parameter
Type
Description

index

The index of the to get.

Returns: Control. The AccordionPanel at the specified location.

Throws:

  • ArgumentOutOfRangeException index is less than 0 or greater than the number of AccordionPanel controls in the Panels collection minus 1.

SelectPanel(index)

Makes the AccordionPanel with the specified index the current AccordionPanel.

Parameter
Type
Description

index

The index in the collection of the tab to select.

Throws:

  • ArgumentOutOfRangeException index is less than 0 or greater than the number of AccordionPanel controls in the Panels collection minus 1.

SelectPanel(panel)

Makes the specified AccordionPanel the current AccordionPanel.

Parameter
Type
Description

panel

The to select.

Throws:

  • ArgumentNullException panel is null.

SelectPanel(panelName)

Makes AccordionPanel with the specified name the current AccordionPanel.

Parameter
Type
Description

panelName

The of the tab to select.

Throws:

  • ArgumentNullException panelName is null; or panelName does not match the Name property of any AccordionPanel in the Panels collection.

Events

Deselected

AccordionEventHandler Fired when a panel is deselected.

Deselecting

AccordionCancelEventHandler Occurs before a panel is deselected, enabling a handler to cancel the panel change.

Selected

AccordionEventHandler Fired when a panel is selected.

SelectedIndexChanged

EventHandler Fired when the SelectedIndex property has changed.

Selecting

AccordionCancelEventHandler Occurs before a panel is selected, enabling a handler to cancel the panel change.

Implements

Name
Description

Bindable components implement this interface.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

Int32
Panels
AccordionPanel
AccordionPanel
AccordionPanel
String
Name
Int32
AccordionPanel
Int32
Panels
AccordionPanel
AccordionPanel
String
Name
IBindableComponent
IWisejComponent
IWisejControl
Control
IWisejSerializable

FileDialog

Wisej.Web.FileDialog

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • CommonDialog

    • FileDialog

Displays a dialog box from which the user can select a file.

public class FileDialog : CommonDialog
Public Class FileDialog
    Inherits CommonDialog

This class is abstract. The current implementations in Wisej are OpenFileDialog and SaveFileDialog. You can override this class or OpenFileDialog and SaveFileDialog to add your own custom behavior and localization. You can:

  • Override PromptFileNotFound. It's called when the specified file doesn't exist and the property CheckFileExists is true.

  • Override CreateUI to create your custom Form when the method ShowDialog is called.

  • Set the DialogTemplate to a Form class that has a constructor that accepts FileDialog as the single argument to change the User Interface (UI) of the file dialog.

  • Override OnFileOk to provide your custom implementation of the actions to execute when the user presses the OK button.

You must add at least one FileSystemProvider to the Roots collection before showing the dialog.

Constructors

FileDialog()

Initializes a new instance of FileDialog.

FileDialog(roots)

Initializes a new instance of FileDialog using the initial roots .

Name
Type
Description

roots

Initial file systems to load in the .

FileDialog(container)

Initializes a new instance of the FileDialog extender with a specified container.

Name
Type
Description

container

An that represents the container of the component.

Properties

AddExtension

Boolean: Returns or sets whether the dialog box automatically adds an extension to a file name if the user omits the extension.

CheckFileExists

Boolean: Returns or sets whether the dialog box displays a warning if the user specifies a file name that does not exist.

DefaultExtension

String: Returns or sets the default file name extension.

FileName

String: Returns or sets a string containing the file name selected in the file dialog box.

FileNames

String[]: Returns the file names of all selected files in the dialog box.

FileSystem

IFileSystemProvider: Returns the IFileSystemProvider that contains the selected FileName.

Filter

String: Returns or sets the current file name filter string, which determines the choices that appear in the "Save as file type" or "Files of type" box in the dialog box.

FilterIndex

Int32: Returns or sets the index of the filter currently selected in the file dialog box.

InitialDirectory

String: Returns or sets the initial directory displayed by the file dialog box.

Roots

FileDialogRootCollection: List of root IFileSystemProvider file systems displayed by the FileDialog.

The Roots collection and the IFileSystemProvider implementations allow the application to use arbitrary names mapped to a specific path. For example, the app may add a root object named "Documents" to "c:\users[logged-user-id]\files\documents". Each user will see "Documents" as the root, but will also see only the files in the [logged-user-id] directory.

ShowHelp

Boolean: Returns or sets whether the Help button is displayed in the file dialog box.

Title

String: Returns or sets the file dialog box title.

Methods

GetRoot(path)

Returns the IFileSystemProvider that contains the specified path .

Parameter
Type
Description

path

Full path of the file to locate in on of the .

Returns: IFileSystemProvider. The IFileSystemProvider that contains the specified path or null if not found.

MapPath(filePath)

Maps the virtual path to the corresponding physical path on the specific IFileSystemProvider implementation.

Parameter
Type
Description

filePath

Virtual path to map to the corresponding physical path.

Returns: String. The physical path for the IFileSystemProvider implementation.

ProcessFileNames(fileNames)

Receives the file names selected by the user and validates them according to the properties set in the FileDialog instance.

Parameter
Type
Description

fileNames

Array containing the selected file paths.

Returns: Boolean. True if the files have been validated and the dialog can close; otherwise false to keep the dialog open.

Reset()

Resets all properties to their default values.

Events

FileOk

CancelEventHandler Fired when the user clicks on the Open or Save button on a file dialog box.

LoadPath

FileDialogLoadPathEventHandler Fired when the file dialog is loading a file or folder.

Inherited By

Name
Description

Prompts the user to open a file from the server.

Prompts the user to select a location for saving a file on the server.

IFileSystemProvider[]
FolderBrowserDialog
IContainer
IContainer
FileDialog
String
Roots
String
String[]
OpenFileDialog
SaveFileDialog

Clipboard

Wisej.Web.Clipboard

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Provides methods to place data on and retrieve data from the system Clipboard. This class cannot be inherited.

public class Clipboard
Public Class Clipboard

Methods

Clear()

Removes all data from the Clipboard.

ContainsAudio()

Indicates whether there is data on the Clipboard in the WaveAudio format.

Returns: Boolean. true if there is audio data on the Clipboard; otherwise, false.

ContainsData(format)

Indicates whether there is data on the Clipboard that is in the specified format or can be converted to that format.

Parameter
Type
Description

format

The format of the data to look for. See for predefined formats.

Returns: Boolean. true if there is data on the Clipboard that is in the specified format or can be converted to that format; otherwise, false.

ContainsFileDropList()

Indicates whether there is data on the Clipboard that is in the FileDrop format or can be converted to that format.

Returns: Boolean. true if there is a file drop list on the Clipboard; otherwise, false.

ContainsImage()

Indicates whether there is data on the Clipboard that is in the Bitmap format or can be converted to that format.

Returns: Boolean. true if there is image data on the Clipboard; otherwise, false.

ContainsText()

Indicates whether there is data on the Clipboard in the Text or UnicodeText format, depending on the operating system.

Returns: Boolean. true if there is text data on the Clipboard; otherwise, false.

ContainsText(format)

Indicates whether there is text data on the Clipboard in the format indicated by the specified TextDataFormat value.

Parameter
Type
Description

format

One of the values.

Returns: Boolean. true if there is text data on the Clipboard in the value specified for format ; otherwise, false.

GetAudioStream()

Retrieves an audio stream from the Clipboard.

Returns: Stream. A Stream containing audio data or null if the Clipboard does not contain any data in the WaveAudio format.

GetData(format)

Retrieves data from the Clipboard in the specified format.

Parameter
Type
Description

format

The format of the data to retrieve. See for predefined formats.

Returns: Object. An Object representing the Clipboard data or null if the Clipboard does not contain any data that is in the specified format or can be converted to that format.

GetDataObject()

Retrieves the data that is currently on the system Clipboard.

Returns: IDataObject. An IDataObject that represents the data currently on the Clipboard, or null if there is no data on the Clipboard.

GetFileDropList()

Retrieves a collection of file names from the Clipboard.

Returns: StringCollection. A StringCollection containing file names or null if the Clipboard does not contain any data that is in the FileDrop format or can be converted to that format.

GetImage()

Retrieves an image from the Clipboard.

Returns: Image. An Image representing the Clipboard image data or null if the Clipboard does not contain any data that is in the Bitmap format or can be converted to that format.

GetText()

Retrieves text data from the Clipboard in the Text or UnicodeText format, depending on the operating system.

Returns: String. The Clipboard text data or Empty if the Clipboard does not contain data in the Text or UnicodeText format, depending on the operating system.

GetText(format)

Retrieves text data from the Clipboard in the format indicated by the specified TextDataFormat value.

Parameter
Type
Description

format

One of the values.

Returns: String. The Clipboard text data or Empty if the Clipboard does not contain data in the specified format.

SetAudio(audioBytes)

Saves the Byte array in the WaveAudio format after converting it to a Stream to the clipboard.

Parameter
Type
Description

audioBytes

A array containing the audio data.

Throws:

  • ArgumentNullException audioBytes is null.

SetAudio(audioStream)

Saves the Stream in the WaveAudio format to the clipboard.

Parameter
Type
Description

audioStream

A containing the audio data.

Throws:

  • ArgumentNullException audioStream is null.

SetClientText(text)

Saves the text data to the client's temporary clipboard. Client side javascript code can copy the clipboard's content to the browser's clipboard calling Wisej.Core.copy();

Parameter
Type
Description

text

The text to save to the client's temporary clipboard.

Throws:

  • ArgumentNullException text is null.

SetData(format, data)

Saves the specified data to the clipboard in the specified format.

Parameter
Type
Description

format

The format of the data to set. See for predefined formats.

data

An representing the data to add.

Throws:

  • ArgumentNullException data is null.

SetDataObject(data)

Saves the specified data to the clipboard.

Parameter
Type
Description

data

The data to place on the Clipboard.

Throws:

  • ArgumentNullException The value of data is null.

SetFileDropList(filePaths)

Saves the collection of file names in the FileDrop format to the clipboard.

Parameter
Type
Description

filePaths

A containing the file names.

Throws:

  • ArgumentNullException filePaths is null.

  • ArgumentException filePaths does not contain any strings, or at least one of the strings in filePaths is empty, contains only white space, contains one or more invalid characters as defined by InvalidPathChars, is null, contains a colon (:), or exceeds the system-defined maximum length. See the InnerException property of the ArgumentException for more information.

SetImage(image)

Saves the Image in the Bitmap format to the clipboard

Parameter
Type
Description

image

The to add to the Clipboard.

Throws:

  • ArgumentNullException image is null.

SetText(text)

Saves the text data in the UnicodeText format to the clipboard.

Parameter
Type
Description

text

The text to add to the Clipboard.

Throws:

  • ArgumentNullException text is null or Empty.

SetText(text, format)

Saves the text data in the format indicated by the specified TextDataFormat value to the clipboard.

Parameter
Type
Description

text

The text to add to the Clipboard.

format

One of the values.

Throws:

  • ArgumentNullException text is null.

String
DataFormats
TextDataFormat
TextDataFormat
String
DataFormats
TextDataFormat
TextDataFormat
Byte[]
Byte
Stream
Stream
String
String
DataFormats
Object
Object
Object
StringCollection
StringCollection
Image
Image
String
String
TextDataFormat
TextDataFormat

DataRepeater

Wisej.Web.DataRepeater

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

  • Control

    • ScrollableControl

      • ContainerControl

        • DataRepeater

Displays data in a customizable list format.

public class DataRepeater : ContainerControl, ISupportInitialize
Public Class DataRepeater
    Inherits ContainerControl
    Implements ISupportInitialize

Constructors

DataRepeater()

Initializes a new instance of the DataRepeater class.

Properties

AllowUserToAddItems

Boolean: Returns or sets whether users can add a new row to the DataRepeater at run time.

AllowUserToDeleteItems

Boolean: Returns or sets whether users can delete a row from the DataRepeater at run time.

BorderStyle

BorderStyle: Returns or sets the border style for the DataRepeater control.

CurrentItem

DataRepeaterItem: Returns the current DataRepeaterItem in the DataRepeater control.

CurrentItemIndex

Int32: Returns or sets the index of the current DataRepeaterItem in a DataRepeater control.

DataMember

String: Return or sets the name of the list or table in the data source for which the DataRepeater is displaying data.

DataSource

Object: Returns or sets the data source for which the DataRepeater is displaying data.

DisplayedItems

DataRepeaterItem[]: Returns the list of DataRepeaterItem items currently displayed on the client.

FirstDisplayedItemIndex

Int32: Return the index of the first currently displayed DataRepeaterItem in a DataRepeater control.

IsCurrentItemModified

Boolean: Return whether the data for a DataRepeaterItem in the DataRepeater control has been changed by a user.

ItemBorderStyle

BorderStyle: Returns or sets the border style for the items in a DataRepeater control.

ItemCount

Int32: Returns or sets the number of DataRepeaterItem items that are in the DataRepeater control.

ItemHeaderSize

Int32: Return sets the size of the item header in a DataRepeater control.

ItemHeaderVisible

Boolean: Returns or sets whether item headers are displayed in a DataRepeater control.

ItemSelectedBackColor

Color: Returns or sets the background color for the DataRepeaterItem panel when it's the CurrentItem.

ItemSize

Size: Returns or sets the size of the DataRepeaterItem child panels.

ItemTemplate

DataRepeaterItem: Returns the template that represents the DataRepeaterItem for the DataRepeater control.

LayoutStyle

DataRepeaterLayoutStyles: Return or sets whether the DataRepeater control will be displayed with a vertical or horizontal orientation.

PrefetchItems

Int32: Returns or sets the number of items to prefetch outside of the visible area. The default is 0 (disabled).

RightToLeftLayout

Boolean: Enables or disables right-to-left layout when the value of RightToLeft is Yes

ScrollBarVisible

Boolean: Returns or sets whether the scrollbar is visible. When the scrollbar is hidden, the user can still scroll using touch events, the keyboard, or the wheel.

VirtualMode

Boolean: Returns or sets a value that indicates whether you have provided your own data-management operations for the DataRepeater control.

Methods

AddNew()

Adds a new DataRepeaterItem to the DataRepeater control.

Throws:

  • ReadOnlyException The AllowUserToAddItems property is set to False.

CancelEdit()

Allows users to cancel an edit to the current child control in the current DataRepeaterItem.

Refresh()

Forces a full reload of the data displayed by this DataRepeater.

Refresh(refreshChildren)

Forces a full reload of the data displayed by this DataRepeater.

Parameter
Type
Description

refreshChildren

True to also refresh all the children of this control.

RemoveAt(index)

Removes a DataRepeaterItem at the specified position from a DataRepeater control.

Parameter
Type
Description

index

The index of the .

Throws:

  • ArgumentOutOfRangeException The value specified for index is less than 0 or greater than ItemCount - 1.

ResetItemBorderStyle()

Resets the value of ItemBorderStyle to the original value.

ResetItemHeaderSize()

Resets the value of ItemHeaderSize to the original value.

ResetItemHeaderVisible()

Resets the value of ItemHeaderVisible to the original value.

ScrollItemIntoView(index)

Scrolls the specified DataRepeaterItem into view.

Parameter
Type
Description

index

The index of the .

Throws:

  • ArgumentOutOfRangeException The value specified for index is less than 0 or greater than ItemCount - 1.

ScrollItemIntoView(index, alignWithTop)

Scrolls a specified DataRepeaterItem into view, optionally aligning it with the top of the control.

Parameter
Type
Description

index

The index of the .

alignWithTop

true to align the top of the with the top of the control; otherwise, false.

Throws:

  • ArgumentOutOfRangeException The value specified for index is less than 0 or greater than ItemCount - 1.

Events

AllowUserToAddItemsChanged

EventHandler Fired when the AllowUserToAddItems property changes.

AllowUserToDeleteItemsChanged

EventHandler Fired when the AllowUserToDeleteItems property changes.

CurrentItemIndexChanged

EventHandler Fired when the property CurrentItemIndex changes.

DataError

DataRepeaterDataErrorEventHandler Fired when an external data-parsing or validation operation throws an exception, or when an attempt to commit data to a data source fails.

DataMemberChanged

EventHandler Fired when the DataMember property changes.

DataSourceChanged

EventHandler Fired when the DataSource property changes.

ItemCloned

DataRepeaterItemEventHandler Fired after the DataRepeaterItem and its controls are cloned from the ItemTemplate.

ItemCloning

DataRepeaterItemCloneEventHandler Fired before the DataRepeaterItem and its controls are cloned from the ItemTemplate.

ItemsAdded

DataRepeaterAddRemoveItemsEventHandler Fired when a new DataRepeaterItem is added to the DataRepeater control.

ItemSelected

DataRepeaterItemEventHandler Fired after the DataRepeaterItem becomes the current item.

ItemsRemoved

DataRepeaterAddRemoveItemsEventHandler Fired when a DataRepeaterItem is deleted from the DataRepeater control.

ItemUpdate

DataRepeaterItemEventHandler Fired when an instance of DataRepeaterItem is updated.

ItemValueNeeded

DataRepeaterItemValueEventHandler Fired when the VirtualMode property is set to true and a new value for a child control of a DataRepeaterItem is needed.

ItemValuePushed

DataRepeaterItemValueEventHandler Fired when the VirtualMode property is set to true and the value of a child control in the DataRepeaterItem changes.

LayoutStyleChanged

EventHandler Fired when the LayoutStyle property changes.

NewItemNeeded

EventHandler Fired when the VirtualMode property is set to true and the user creates a new DataRepeaterItem.

UserAddedItems

DataRepeaterAddRemoveItemsEventHandler Fired when the user adds a new DataRepeaterItem.

UserDeletedItems

DataRepeaterAddRemoveItemsEventHandler Fired after the user deletes a DataRepeaterItem.

UserDeletingItems

DataRepeaterAddRemoveItemsCancelEventHandler Fired when the user deletes a DataRepeaterItem.

VirtualModeChanged

EventHandler Fired when the VirtualMode property changes.

Implements

Name
Description

Bindable components implement this interface.

Provides the functionality for a control to act as a parent for other controls.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

Boolean
Int32
DataRepeaterItem
Int32
DataRepeaterItem
Int32
DataRepeaterItem
Boolean
DataRepeaterItem
IBindableComponent
IContainerControl
IWisejComponent
IWisejControl
Control
IWisejSerializable

DataObject

Wisej.Web.DataObject

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Implements a basic data transfer mechanism.

public class DataObject : IDataObject
Public Class DataObject
    Inherits IDataObject

Constructors

DataObject()

Initializes a new instance of the DataObject class.

DataObject(data)

Initializes a new instance of the DataObject class and adds the specified object to it.

Name
Type
Description

data

The data to store.

DataObject(format, data)

Initializes a new instance of the DataObject class and adds the specified object in the specified format.

Name
Type
Description

format

The format of the specified data. See for predefined formats.

data

The data to store.

Methods

ContainsAudio()

Indicates whether the data object contains data in the WaveAudio format.

Returns: Boolean. true if the data object contains audio data; otherwise, false.

ContainsFileDropList()

Indicates whether the data object contains data that is in the FileDrop format or can be converted to that format.

Returns: Boolean. true if the data object contains a file drop list; otherwise, false.

ContainsImage()

Indicates whether the data object contains data that is in the Bitmap format or can be converted to that format.

Returns: Boolean. true if the data object contains image data; otherwise, false.

ContainsText()

Indicates whether the data object contains data in the UnicodeText format.

Returns: Boolean. true if the data object contains text data; otherwise, false.

ContainsText(format)

Indicates whether the data object contains text data in the format indicated by the specified TextDataFormat value.

Parameter
Type
Description

format

One of the values.

Returns: Boolean. true if the data object contains text data in the specified format; otherwise, false.

GetAudioStream()

Retrieves an audio stream from the data object.

Returns: Stream. A Stream containing audio data or null if the data object does not contain any data in the WaveAudio format.

GetData(format)

Returns the data associated with the specified class type format.

Parameter
Type
Description

format

A representing the format of the data to retrieve.

Returns: Object. The data associated with the specified format, or null.

GetData(format)

Returns the data associated with the specified data format.

Parameter
Type
Description

format

The format of the data to retrieve. See for predefined formats.

Returns: Object. The data associated with the specified format, or null.

GetData(format, autoConvert)

Returns the data associated with the specified data format, using an automated conversion parameter to determine whether to convert the data to the format.

Parameter
Type
Description

format

The format of the data to retrieve. See for predefined formats.

autoConvert

true to the convert data to the specified format; otherwise, false.

Returns: Object. The data associated with the specified format, or null.

GetDataPresent(format)

Determines whether data stored in this DataObject is associated with, or can be converted to, the specified format.

Parameter
Type
Description

format

A representing the format to check for.

Returns: Boolean. true if data stored in this DataObject is associated with, or can be converted to, the specified format; otherwise, false.

GetDataPresent(format)

Returns the data associated with the specified class type format.

Parameter
Type
Description

format

A representing the format of the data to retrieve.

Returns: Boolean. The data associated with the specified format, or null.

GetDataPresent(format, autoConvert)

Determines whether this DataObject contains data in the specified format or, optionally, contains data that can be converted to the specified format.

Parameter
Type
Description

format

The format to check for. See for predefined formats.

autoConvert

true to determine whether data stored in this can be converted to the specified format; false to check whether the data is in the specified format.

Returns: Boolean. true if the data is in, or can be converted to, the specified format; otherwise, false.

GetFormats()

Returns a list of all formats that data stored in this DataObject is associated with or can be converted to.

Returns: String[]. An array of type String, containing a list of all formats that are supported by the data stored in this object.

GetFormats(autoConvert)

Returns a list of all formats that data stored in this DataObject is associated with or can be converted to, using an automatic conversion parameter to determine whether to retrieve only native data formats or all formats that the data can be converted to.

Parameter
Type
Description

autoConvert

true to retrieve all formats that data stored in this is associated with, or can be converted to; false to retrieve only native data formats.

Returns: String[]. An array of type String, containing a list of all formats that are supported by the data stored in this object.

GetImage()

Retrieves an image from the data object.

Returns: Image. An Image representing the image data in the data object or null if the data object does not contain any data that is in the Bitmap format or can be converted to that format.

GetText()

Retrieves text data from the data object in the UnicodeText format.

Returns: String. The text data in the data object or Empty if the data object does not contain data in the UnicodeText format.

GetText(format)

Retrieves text data from the data object in the format indicated by the specified TextDataFormat value.

Parameter
Type
Description

format

One of the values.

Returns: String. The text data in the data object or Empty if the data object does not contain data in the specified format.

SetAudio(audioBytes)

Adds a Byte array to the data object in the WaveAudio format after converting it to a Stream.

Parameter
Type
Description

audioBytes

A array containing the audio data.

Throws:

  • ArgumentNullException audioBytes is null.

SetAudio(audioStream)

Adds a Stream to the data object in the WaveAudio format.

Parameter
Type
Description

audioStream

A containing the audio data.

Throws:

  • ArgumentNullException audioStream is null.

SetData(data)

Adds the specified object to the DataObject using the object type as the data format.

Parameter
Type
Description

data

The data to store.

SetData(format, data)

Adds the specified object to the DataObject using the specified type as the format.

Parameter
Type
Description

format

A representing the format associated with the data.

data

The data to store.

SetData(format, data)

Adds the specified object to the DataObject using the specified format.

Parameter
Type
Description

format

The format associated with the data. See for predefined formats.

data

The data to store.

SetData(format, autoConvert, data)

Adds the specified object to the DataObject using the specified format and indicating whether the data can be converted to another format.

Parameter
Type
Description

format

The format associated with the data. See for predefined formats.

autoConvert

true to allow the data to be converted to another format; otherwise, false.

data

The data to store.

SetDownloadURL(url, fileName)

Adds a url using DownloadURL format. The specified url is parsed to compose the DownloadURL as: "mime-type:file-name:url".

Parameter
Type
Description

url

The url to the file to download.

fileName

The name of the file to download from the url.

SetFileDropList(filePaths)

Adds a collection of file names to the data object in the FileDrop format.

Parameter
Type
Description

filePaths

A containing the file names.

Throws:

  • ArgumentNullException filePaths is null.

SetImage(image)

Adds an Image to the data object in the Bitmap format.

Parameter
Type
Description

image

The to add to the data object.

Throws:

  • ArgumentNullException image is null.

SetText(textData)

Adds text data to the data object in the UnicodeText format.

Parameter
Type
Description

textData

The text to add to the data object.

Throws:

  • ArgumentNullException textData is null or Empty.

SetText(textData, format)

Adds text data to the data object in the format indicated by the specified TextDataFormat value.

Parameter
Type
Description

textData

The text to add to the data object.

format

One of the values.

Throws:

  • ArgumentNullException textData is null or Empty.

Implements

Name
Description

Provides a format-independent mechanism for transferring data.

Object
String
DataFormats
Object
TextDataFormat
TextDataFormat
Type
Type
String
DataFormats
String
DataFormats
Boolean
Type
Type
String
Type
String
DataFormats
Boolean
DataObject
Boolean
DataObject
TextDataFormat
TextDataFormat
Byte[]
Byte
Stream
Stream
Object
Type
Type
Object
String
DataFormats
Object
String
DataFormats
Boolean
Object
String
String
StringCollection
StringCollection
Image
Image
String
String
TextDataFormat
TextDataFormat
IDataObject

Application

Wisej.Web.Application

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represent a Wisej application session. Provides methods and events to manage the application in the context of the current session.

public class Application : IWisejComponent, IDisposable, IWisejSynchronized
Public Class Application
    Inherits IWisejComponent
    Implements IDisposable, IWisejSynchronized

This class provides several static methods, properties and events that allow the application to manage all sorts of features related to the current session:

  • Save and retrieve session variable. Use Session to store and retrieve session variable. The property is a dynamic object and a Dictionary, therefore you can access its properties directly or through the indexer.

    Application.Session.myValue = 12;
    Application.Session["myValue"] = 12;
  
  • Manage cookies. Use Cookies to manage browser's cookies.

  • Read server variables. Use ServerVariables to retrieve all the data made available by the server. Some of the variables in the collection are also available directly: ServerPort, ServerName, UserAgent, etc.

  • Read the application's URL. Use Uri, Url, StartupUri, and StartupUrl.

  • Read the applications's system information. Use StartupPath, ProductName, ProductVersion, etc.

  • Listen to the application's global events. See SessionTimeout , BeginRequest, ApplicationStart, ApplicationExitApplicationRefresh, BrowserSizeChangedResponsiveProfileChanged, CultureChanged, and many more.

  • Retrieve browser related information. Use the Browser to read the client browser type, OS, version, capabilities, screen size, browser size, language, and state. The Browser object is updated automatically when the user resizes the browser or the page is reloaded.

  • Control the client browser. Start a Download, execute JavaScript functions or scriptlets using Call or Eval. Make the browser navigate to a different URL using Navigate or simply Reload the page.

  • Manage the main page or current desktop. MainPage lets you change the Page object that fills the browser and "navigate" from page to page. Desktop lets you change the active Desktop object on the client browser.

  • Manage all live components in the session. Through the Application class you can find, iterate, inspect all live components of any type. See OpenForms for all the currently created (visible or invisible) instances of Form. OpenPages returns all the created Page objects. FindComponent and FindComponents provide an easy way to find any component in the session or to iterate the list of components that match a custom expression.

  • Start background tasks in context. StartTask provides a powerful way to start a background task on the server that can keep interacting with the client browser while running independently.

  • Manage the application's theme. Use LoadTheme to load a Wisej theme into the application. Or use the Theme object to read all sorts of information from the current ClientTheme.

  • Terminate the application without waiting for the session to timeout. Use Exit to terminate the current session and free all the related memory.

There is a lot more exposed by the Application class. You can inspect all the properties and methods in Visual Studio through IntelliSense or online at docs.

Properties

ActiveProfile

ClientProfile: Returns or sets the current client responsive profile.

This is the profile that best matches the current browser on the client. It is updated automatically on every request.

Browser

ClientBrowser: Returns or sets the client browser information.

ClientFingerprint

UInt32: Returns the unique client "fingerprint" ID. It can be used to distinguish client devices.

The client fingerprint is generated by hashing all the available information returned by the browser (OS, user agent, version, etc.) and it's not guaranteed to be unique.

CommonAppDataPath

String: Returns the path for the application data that is shared among all users.

CommonAppDataRegistry

RegistryKey: Returns the registry key for the application data that is shared among all users.

CompanyName

String: Returns the company name associated with the application stored in the AssemblyCompanyAttribute.

Configuration

Configuration: Returns the current Configuration.

Cookies

CookieCollection: Collection of cookies.

Current

IWisejComponent: Returns the application component instance that an application can store and use later to restore the context when updating client widgets during an out-of-bound call using Update

Threads that are not started using StartTask don't have any knowledge of the current session and don't have a way to communicate with the client The Current property returns the instance of the Application class that is bound to the current session. It can be used just like any other component with Update or RunInContext to restore the session for the current thread. The advantage of using Current instead of the instance of a control or a page is to avoid to keep a reference to a component that may be disposed by the application.

var current = Application.Current;
var thread = new Thread(() => {
  Application.Update(current, () => {
  
    // code here is running in context.
    
  });
});

CurrentCulture

CultureInfo: Returns or sets the current CultureInfo for the session.

Desktop

Desktop: Returns or sets the current Desktop.

EnableUnloadConfirmation

Boolean: Returns or sets whether the browser will ask the user to confirm unloading the current page.

This property attaches the window.onbeforeunload event. See https://developer.mozilla.org/en-US/docs/Web/API/WindowEventHandlers/onbeforeunload. It's not possible to determine whether the page is being unloaded because the user is trying to close the tab, close the browser, or is refreshing the page, or is taking any other action that may reload the page.

ExecutablePath

String: Returns the path for the application's main assembly.

FavIcon

Image: Returns or sets the favicon to display in the browser.

FavIconSource

String: Returns or sets the URL to the favicon to display in the browser.

Hash

String: Returns or sets the hash part of the URL on the client.

IsAuthenticated

Boolean: Returns a value indicating whether the session has been authenticated.

IsDisposed

Boolean: Indicates that the current application instance, which corresponds to the session, has been terminated and disposed.

IsExpired

Boolean: Returns true when the current session has expired.

IsSecure

Boolean: Returns true if this session is running in secure mode (https:// and wss://)

IsTerminated

Boolean: Returns true when the current session has been terminated.

IsWebSocket

Boolean: Returns true if the current session is connected using WebSocket.

LicenseKey

String: Returns or sets the runtime server license key.

Setting the LicenseKey programmatically has to be done before the application is loaded. The best place is the static constructor for the Program static class, or the static constructor of the main window (if defined in Default.js).

static class Program
{
  static Program()
  {
    Application.LicenseKey = "...";
  }
}

MainPage

Page: Returns or sets the current full page window.

OpenForms

FormCollection: Returns a collection of open forms owned by the application.

OpenPages

PageCollection: Returns a collection of open pages owned by the application.

Platform

ClientPlatform: The name of the currently loaded platform.

ProductName

String: Returns the product name associated with this application.

ProductVersion

String: Returns the product version associated with this application stored either in AssemblyInformationalVersionAttribute or AssemblyFileVersionAttribute.

QueryString

NameValueCollection: Returns the parameters used to launch the application.

RightToLeft

Boolean: Returns or sets whether all the controls in the applications should operate using the right-to-left mode.

The value of this property is updated automatically when the current language changes if the value of "rightToLeft" in the application configuration file is set to "auto".

RuntimeMode

Boolean: Returns true when the application is running in not in design, debug or test mode.

ServerName

String: Returns the server's host name, DNS alias, or IP address as it would appear in self-referencing URLs.

ServerPort

Int32: Returns the port number to which the request was sent.

ServerVariables

NameValueCollection: Returns the server variables.

Session

Object: Provides a generic storage for session-based objects.

SessionCount

Int32: Returns the total number of currently active sessions.

SessionId

String: Returns the unique current session ID.

ShowConsole

Boolean: Shows or hides the debug console on the browser.

Displays a simple HTMl only debug console. Works with any browser also when the developer tools are not available.

ShowLoader

Boolean: Returns or sets whether the browser is blocked by the Ajax loader.

StartupPath

String: Returns the root path of the web application.

StartupUri

Uri: Returns the URI used to start the application.

StartupUrl

String: Returns the URL used to start the application.

Theme

ClientTheme: Returns or sets the current ClientTheme.

You can create and modify a new custom theme using the ClientTheme class. The new theme can be based on an existing theme, can be empty, or can be initialized from a JSON string.

// create a new custom theme cloned from the current theme.
var myTheme = new ClientTheme("MyTheme", Application.Theme);

// alter the buttonFace color.
myTheme.Colors.buttonFace = "red";

// update the current session using the new custom theme.
Application.Theme = myTheme;

You may also alter a global theme shared by all sessions.


// change the buttonFace color in the current theme.
// if the theme is one of the global themes, i.e. it was loaded
// using Application.LoadTheme(name), then the change is also global.
Application.Theme.Colors.buttonFace = "red";

// since the theme objects are all dynamic and use a special DynamicObject
// class part of the Wisej Framework, you can also use a string indexer
// to address any field.
Application.Theme.Colors["buttonFace"] = "red";

Title

String: Returns or sets the page title in the browser.

Uri

Uri: Returns the current Uri used either to launch or reload the application. It may be different from StartupUri.

Url

String: Returns the current URL used either to launch or reload the application. It may be different from StartupUrl.

User

IPrincipal: Returns the security information for the current request.

UserAgent

String: Returns the raw user agent string of the client browser.

UserHostAddress

String: Returns the IP host address of the remote client.

UserHostName

String: Gets the DNS name of the remote client.

UserIdentity

WindowsIdentity: Returns the WindowsIdentity type for the current user.

UserLanguages

String[]: Gets a sorted string array of client language preferences.

Methods

AddEventFilter(filter)

Adds an event filter to monitor all the incoming events before they are routed to their respective component.

Parameter
Type
Description

filter

An object that implements the interface to add to the filter list.

AddTranslation(text, translation)

Adds the text and corresponding translation to the default locale on the client.

Parameter
Type
Description

text

The text to translate.

translation

The translation override.

Call(function, args)

Executes the JavaScript function on the client.

Parameter
Type
Description

function

The name of the function to execute.

args

The arguments to pass to the function.

Call(function, callback, args)

Executes the JavaScript function on the client and receives the return value (or null) in the callback method.

Parameter
Type
Description

function

The name of the function to execute.

callback

Asynchronous callback method that receives the return value.

args

The arguments to pass to the function.

CallAsync(function, args)

Asynchronously executes the JavaScript function on the client and returns an awaitable Task with the result of the remote call.

Parameter
Type
Description

function

The name of the function to execute.

args

The arguments to pass to the function.

Returns: Task<Object>. An awaitable Task that represents the asynchronous operation.

CancelFullScreen()

Cancels the fullscreen mode.

Download(filePath, fileName)

Downloads the specified file on the client.

Parameter
Type
Description

filePath

The file to download.

fileName

The name of the file to save on the client.

Download(image, fileName)

Downloads the specified image to the client.

Parameter
Type
Description

image

The image to download.

fileName

The name of the file to save on the client.

Download(stream, fileName)

Downloads the bytes in the stream to the client.

Parameter
Type
Description

stream

The stream to send to the client.

fileName

The file name the client will use to save the stream.

DownloadAndOpen(target, filePath, fileName)

Downloads the specified file on the client.

Parameter
Type
Description

target

Specifies where to open the file. Leave empty or use "_self" to open in the current tab, _blank to open in a new tab.

filePath

The file to download.

fileName

The name of the file to save on the client.

DownloadAndOpen(target, image, fileName)

Downloads the specified image to the client.

Parameter
Type
Description

target

Specifies where to open the file. Leave empty or use "_self" to open in the current tab, _blank to open in a new tab.

image

The image to download.

fileName

The name of the file to save on the client.

DownloadAndOpen(target, stream, fileName)

Downloads the bytes in the stream to the client.

Parameter
Type
Description

target

Specifies where to open the file. Leave empty or use "_self" to open in the current tab, _blank to open in a new tab.

stream

The stream to send to the client.

fileName

The file name the client will use to save the stream.

EndPolling()

Stops the polling requests from the client.

Eval(script)

Executes the JavaScript script on the client.

Parameter
Type
Description

script

The script to evaluate.

Eval(script, callback)

Executes the JavaScript script on the client and receives the return value (or null) in the callback method.

Parameter
Type
Description

script

The script to evaluate.

callback

Asynchronous callback method that receives the return value.

EvalAsync(script)

Asynchronously executes the JavaScript script on the client and returns an awaitable Task with the result of the remote call.

Parameter
Type
Description

script

The script to evaluate.

Returns: Task<Object>. An awaitable Task that represents the asynchronous operation.

Exit()

Terminates the application and the corresponding session.

FindComponent(match)

Find the first component that matches the conditions defined in the predicate function.

Parameter
Type
Description

match

A custom expression used to match the to find.

Returns: IWisejComponent. The first IWisejComponent qualified by the match expression.

This method lets an application find any live component in the current session.

  // Find the first component that is a Button with Text = "OK"
  var button = Application.FindComponent(c => c is Button && ((Button)c).Text == "OK");

FindComponents(match)

Finds all the components that match the conditions in the predicate function.

Parameter
Type
Description

match

A custom expression used to match the list of objects to find.

Returns: IList<IWisejComponent>. The list of IWisejComponent instances qualified by the match expression.

This method lets an application iterate through all the live components in the current session.

  // List all text boxes that are read only in all forms.
  var list = Application.FindComponents(c => c is TextBox && ((TextBox)c).ReadOnly);

LoadAssembly(filePath)

Loads an assembly given the file name or path.

Parameter
Type
Description

filePath

The file name or full path for the assembly to load.

Returns: Assembly. The loaded Assembly.

This method loads the assembly and, if the assembly contains Wisej components that need embedded resources - like JavaScript classes or CSS styles - that are embedded in the assembly, notifies the client with the URL to load the additional resources dynamically.

LoadComponent(filePath, className)

Creates an instance of the specified component from the assembly.

Parameter
Type
Description

filePath

The file name or full path for the assembly to load.

className

Returns: IWisejComponent. An instance of a Wisej component implementing the IWisejComponent interface.

LoadPackages(packages, callback)

Parameter
Type
Description

packages

callback

LoadPackagesAsync(packages)

Parameter
Type
Description

packages

Returns: Task<Boolean>.

LoadTheme(name, mixins)

Changes the current theme.

Parameter
Type
Description

name

Name of the theme resource. Use only the name without the path and without the extension.

mixins

Optional list of theme mixins. If null, the default theme mixins are always applied.

MapPath(path)

Returns the full file path in relation to the application's project directory.

Parameter
Type
Description

path

Returns: String. The full path relative to the current application's root directory.

Navigate(url, target)

Navigate to the specified URL.

Parameter
Type
Description

url

URL to navigate to.

target

The target browser window: _self, _blank, etc.

Play(type)

Plays one of the built-in sounds

Parameter
Type
Description

type

One of value that identifies the sound to play.

Play(soundUrl)

Plays a sound.

Parameter
Type
Description

soundUrl

A string representing either a sound file URL or a base64 data URL.

Post(callback)

Executes the callback method after all processing is completed and before updating the client.

Parameter
Type
Description

callback

Method to invoke after the request has completed but before sending the response to the server.

The Post() method is similar to the BeginInvoke() method used by desktop applications. It allows you to execute a block of code out of sync with the current execution flow.


void Test() {

  Application.Post(() => {
    this.listBox.Items.Add("1");
  });
  
  this.listBox.Items.Add("2");
  
  // The items will be added in this order: "2", "1".
}

Print(window)

Prints the specified window.

Parameter
Type
Description

window

The window to print

The window is printed without the caption or the borders, if present.

Print()

Prints the entire browser window.

Reload()

Causes the application to reload on the browser.

RemoveEventFilter(filter)

Removes the filter from the list of registered event filters.

Parameter
Type
Description

filter

An object that implements the interface to remove from the filter list.

RequestFullScreen()

Requests the browser to enable fullscreen mode if supported.

RunInContext(context, action)

Executes the callback in context.

Parameter
Type
Description

context

The application context to update. It can be any Wisej component or the returned by the property .

action

Function to execute in context. The code in the function can access all the static Application properties when executed from an out-of-bound thread.

StartPolling(interval)

Instructs the client to start polling the server for UI changes at the specified interval when a WebSocket connection is not available.

Parameter
Type
Description

interval

Polling interval in milliseconds. The minimum is 1000ms.

Calling this method when IsWebSocket is true has no effect. Use client side polling when you know that your code will start a background task that needs to update the client asynchronously (push updates) and your server or clients don't support WebSocket connections. Once the background tasks are completed call EndPolling to reduce the incoming requests from the client.


// this has not effect when the client and server are connected using WebSocket.
Application.StartPolling(1000);

Application.StartTask(() => {

  for (int i = 0; i < 100; i++) {
    this.label1.Text = "Counting..." + i;
    Thread.Sleep(1000);
  }
  
  // this has not effect when the client and server are NOT connected using WebSocket.
  Application.Update(this);

  // this has not effect when the client and server are connected using WebSocket.
  Application.EndPolling();

});

Throws:

  • ArgumentOutOfRangeException The interval specified is less than 1.

StartTask(action)

Starts a new task within the current application context and returns immediately. See also BackgroundTasks.

Parameter
Type
Description

action

Start method invoked by the new task when it starts up.

Returns: Task. An awaitable Task.

The task runs in the background but it's still capable of updating the client asynchronously when working with WebSocket by calling the Update method to push the UI updates to the client browser. If you want to support background updates for clients or servers that can't use the WebSocket connection, you can either add a Timer component to the parent container to force period requests to the server, or you can use the StartPolling and EndPolling methods.

Application.StartTask(() => {

  for (int i = 0; i < 100; i++) {
  
    this.label1.Text = "Counting..." + i;
    
    // just wait a bit or it's too fast.
    Thread.Sleep(1000);
    Application.Update(this);
  }
});

StartTask<T>(action)

Starts a new task with a return value within the current application context and returns immediately. See also BackgroundTasks.

Parameter
Type
Description

T

action

Start method invoked by the new task when it starts up.

Returns: Task<T>.

The task runs in the background but it's still capable of updating the client asynchronously when working with WebSocket by calling the Update method to push the UI updates to the client browser. The generics overload of StartTask allows the task to return a value. You can use this with the async/await pattern and asynchronously wait for the task to complete. If you want to support background updates for clients or servers that can't use the WebSocket connection, you can either add a Timer component to the parent container to force period requests to the server, or you can use the StartPolling and EndPolling methods.

string text = await Application.StartTask(() => {

  string value = "";
  for (int i = 0; i < 100; i++) {
  
    value += i.ToString();
    
    // just wait a bit or it's too fast.
    Thread.Sleep(100);
  }
  return value;
});

this.label.Text = text;
Application.Update(this);

Note that you don't have to specify the type in the angular brackets, the compiler will automatically detect the type from the return value of the asynchronous function.

StartTimer(dueTime, period, callback)

Starts a Timer bound to the current session context.

Parameter
Type
Description

dueTime

The amount of time, in milliseconds, to delay before invoking the callback .

period

The time interval between invocations, in milliseconds.

callback

A callback method to invoke at the specified intervals.

Returns: Timer. An instance of Timer.

You must save a reference to the returned Timer or the Garbage Collector will stop and dispose the timer. To alter the invocation period user Timer.Changer(), or stop the timer simply use Timer.Dispose(). See system.threading.

Update(context, action)

Executes the optional callback in context and pushes all the pending updates to the client when in WebSocket mode.

Parameter
Type
Description

context

The application context to update. It can be any Wisej component or the returned by the property .

action

Function to execute in context. The code in the function can access all the static Application properties when executed from an out-of-bound thread.

Use this method when you need to update the client asynchronously from an out-of-bound thread (different thread, not originating from a client request). You can call this method at the end of the code that updates the UI:

Application.StartTask(() => {

    for (int i = 0; i < 100; i++) {
    
      this.label1.Text = "Counting..." + i;
      
      // just wait a bit or it's too fast.
      Thread.Sleep(1000);
    }
    
    Application.Update(this);

});

Or you can use the optional action function to enclose the code that updates the UI in a block and ensure that the client is updated when the code block exits:

Application.StartTask(() => {

    Application.Update(this, () => {
    
      for (int i = 0; i < 100; i++) {
    
        this.label1.Text = "Counting..." + i;
      
        // just wait a bit or it's too fast.
        Thread.Sleep(1000);
      }
    });

});

Events

ActiveWindowChanged

EventHandler Fired when the active window changes.

ApplicationExit

EventHandler Fired when the application is about to shut down.

ApplicationRefresh

EventHandler Fired when the application is reloaded in the browser because the user hit refresh or changed the URL.

ApplicationStart

EventHandler Fired when the application is started, after the Main method is called.

BeforeInstallPrompt

EventHandler Fired when the browser fires the "beforeinstallprompt" event. Corresponds to BeforeInstallPromptEvent.

BeginRequest

EventHandler Fired at the beginning of every request.

BrowserSizeChanged

EventHandler Fired when the user resizes the browser.

BrowserTabActivated

EventHandler Fired when the user activates the browser tab.

BrowserTabDeactivated

EventHandler Fired when the user deactivates the browser tab.

CultureChanged

EventHandler Fired when the CurrentCulture changes.

EndRequest

EventHandler Fired at the end of every request.

FocusedControlChanged

EventHandler Fired when the focused control changes.

HashChanged

HashChangedEventHandler Fired when the hash part of the URL changes on the client side.

Idle

EventHandler Fired when the current thread has completed processing all the events and before the response is sent back to the client.

ResponsiveProfileChanged

ResponsiveProfileChangedEventHandler Fired when the active responsive profile is changed.

RightToLeftChanged

EventHandler Fired when the RightToLeft value changes.

SessionTimeout

HandledEventHandler Fired when the session is about to time out.

The default behavior built-in Wisej is to display a dialog asking the user to prolong the session. Set Handled to true to stop the default behavior.

ThemeChanged

EventHandler Fired when the current theme is changed.

ThreadException

ThreadExceptionEventHandler Fired when a thread exception is thrown.

Implements

Name
Description

All wisej components implement this interface.

IEventFilter
IEventFilter
String
String
String
Object[]
String
Action<Object>
Object[]
String
Object[]
String
String
Image
String
Stream
String
String
String
String
String
Image
String
String
Stream
String
String
String
Action<Object>
String
Predicate<IWisejComponent>
Predicate
IWisejComponent
Predicate<IWisejComponent>
Predicate
IWisejComponent
String
String
String
IEnumerable<Package>
Action<Boolean>
IEnumerable<Package>
String
String[]
String
String
String
MessageBoxIcon
MessageBoxIcon
String
Action
IWisejWindow
IEventFilter
IEventFilter
IWisejComponent
IWisejComponent
Context
Action
Int32
Action
Func<T>
Int32
Int32
Action
IWisejComponent
IWisejComponent
Context
Action
IWisejComponent

Control

Wisej.Web.Control

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Base class for all Wisej controls.

public class Control : IWisejControl, IWisejComponent, IBindableComponent, IWisejSerializable, IHasPropertyStore, IHasResponsiveProfiles
Public Class Control
    Inherits IWisejControl
    Implements IWisejComponent, IBindableComponent, IWisejSerializable, IHasPropertyStore, IHasResponsiveProfiles

Constructors

Control()

Initializes a new instance of the Control class.

Properties

AccessibleDescription

String: Returns or sets the description that will be reported to accessibility client applications. It is assigned to the "alt" attribute of the browser element.

AccessibleName

String: Returns or sets the name of the control for use by accessibility client applications. It is assigned to the "name" attribute of the browser element.

AccessibleRole

AccessibleRole: Returns or sets the accessible role of the control that will be reported to accessibility client applications. It is assigned to the "role" attribute of the browser element.

AllowDrag

Boolean: Returns or sets whether the control can initiate a drag-drop operation.

AllowDrop

Boolean: Returns or sets whether the control can accept data that the user drags onto it.

Anchor

AnchorStyles: Returns or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.

Anonymous

Boolean: Returns or sets whether the control receives pointer events. Anonymous controls let pointer events bubble to their parents.

BackColor

Color: Returns or sets the background color for the control.

BackgroundImage

Image: Returns or sets the background image displayed in the control.

BackgroundImageLayout

ImageLayout: Returns or sets the background image layout as defined in the ImageLayout enumeration.

BackgroundImageSource

String: Returns or sets the background image displayed in the control.

BecomingActiveControl

Boolean: Returns a flag indicating that the control is becoming the active control.

CanExecute

Boolean: Determines whether the control can execute a command.

CanFocus

Boolean: Returns whether the control can receive focus.

CausesValidation

Boolean: Returns or sets whether the control causes validation to be performed on controls that require to be validated when this control receives focus.

ClientEvents

ClientEventCollection: Returns a collection of client events and JavaScript listeners. You may attach multiple listeners to same event.

You can use this collection at design time or in code or through the listener methods:

  • AddClientEventListener

  • HasClientEventListener

  • RemoveClientEventListener

  • RemoveClientEventListener

  • GetClientEventListener

ContainsFocus

Boolean: Indicates whether the control, or one of its child controls, has the input focus.

ContextMenu

ContextMenu: Returns or sets the shortcut menu associated with the control.

Controls

ControlCollection: Returns the collection of controls contained within the control.

CssClass

String: Returns or sets additional CSS class names to add to the widget.

Use this property to add or remove custom CSS classes that you may add to your application as standard css files or through the StyleSheet extender. You can assign multiple class names separated by a space and you can manage this property using the related methods:

  • AddCssClass

  • RemoveCssClass

  • HasCssClass

CssStyle

String: Returns or sets the custom CSS styles to add to the widget.

You can use any CSS style string.


  // set the border radius to 100% and make the control round.
  this.button1.CssStyle = "border-radius:100%";

Cursor

Cursor: Returns or sets the cursor that is displayed when the mouse pointer is over the control.

DataBindings

ControlBindingsCollection: Returns the data bindings for the control.

DefaultBackColor

Color: Returns the default background color of the control.

DefaultFont

Font: Returns the default font of the control.

DefaultForeColor

Color: Returns the default background color of the control.

DisplayRectangle

Rectangle: Returns the rectangle that represents the virtual display area of the control.

Dock

DockStyle: Returns or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

Enabled

Boolean: Returns or sets whether the control can respond to user interaction.

EnableNativeContextMenu

Boolean: Enables or disables the browser's context menu.

Focusable

Boolean: Returns or sets whether the control can gain the focus.

Focused

Boolean: Returns a value indicating whether the control has input focus.

Font

Font: Gets or sets the font of the text displayed by the control.

ForeColor

Color: Returns or sets the text color of the control.

Handle

IntPtr: Returns the unique server-side id (handle) for this component.

HasDataBindings

Boolean: Returns whether the control specifies data bindings.

HasResponsiveProfiles

Boolean: Check if the control defines any responsive profile without forcing the creation of the collection.

HasUserData

Boolean: Checks if the UserData dynamic object was created and has any value.

Height

Int32: Returns or sets the height of the control.

InitScript

String: Returns or sets an initialization script to execute when the widget is created (or reloaded) in the browser.

Use this property to add custom initialization JavaScript that is always executed when the client widget is created. The context (this) of the script is the instance of the widget. You can use the entire qooxdoo and wisej.js api. See #qx and wisej-js.

  // change the background color of the internal label of the button widget.
  this.button1.InitScript = "this.getChildControl('label').setBackgroundColor('red')";

  // attach a JavaScript event handler.
  this.textBox1.InitScript = @"this.addListener('keydown', function(e) {
    if (e.getKeyIdentifier() == "PageDown") {
      alert('You pressed PageDown.');
    }
  });

You may also use the init script to attach events to the widget or to its internal children. Event handlers can also be attached using the ClientEvents collection and the client events methods:

  • AddClientEventListener

  • HasClientEventListener

  • RemoveClientEventListener

  • RemoveClientEventListener

  • GetClientEventListener

IsHandleCreated

Boolean: Returns if the control has a server-side component id (handle) associated with it.

IsMirrored

Boolean: Returns whether the control is mirrored.

LayoutEngine

LayoutEngine: Returns the control's layout engine.

Left

Int32: Returns or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.

Location

Point: Returns or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.

Margin

Padding: Returns or sets the space between controls.

MaximumSize

Size: Returns or sets the maximum size for the control.

MinimumSize

Size: Returns or sets the minimum size for the control.

ModifierKeys

Keys: Returns a value indicating which of the modifier keys (SHIFT, CTRL, and ALT) is in a pressed state.

MouseButtons

MouseButtons: Returns a value indicating which of the mouse buttons is in a pressed state.

MousePosition

Point: Returns the position of the mouse cursor in screen coordinates.

Movable

Boolean: Returns or sets whether the control can be moved by dragging.

Name

String: Gets or sets the name of the control.

Padding

Padding: Returns or sets padding within the control.

Parent

Control: Returns or sets the parent container of the control.

PreferredSize

Size: Returns the preferred size in which the control can fit.

ResizableEdges

AnchorStyles: Returns or sets the edges of the control that can be dragged to resize the control.

ResponsiveProfiles

ResponsiveProfileCollection: Returns the collection of responsive properties that have been set for this control.

RightToLeft

RightToLeft: Returns or sets whether the control's elements are aligned right-to-left to support RTL languages.

When set to Inherit, the control inherits the value of this property from its parent. However, when the control is a top-level control (i.e. Window, Page, Desktop), and the value is set to Inherit, the right-to-left mode is automatically retrieved from the current language.

The behavior of this property is configurable in Default.json setting the "rightToLeft" property to "true", "false", or "auto". The default is "auto", causing the value to be retrieved from the current language.

ShowLoader

Boolean: Returns or sets whether the control is blocked by the ajax loader.

Size

Size: Returns or sets the height and width of the control.

States

String[]: Returns or sets additional theme states to the client widget.

Use this property to manage additional custom states that you may want to add to a widget. The state will update the visualization of the widget using the styles and properties set in the current theme and loaded theme mixins. You can also force the usage of built-in states. However, this property will not return the current states of the widget as updated by the client browser. It only returns the states set by the application.

  // force the widget to update the UI as if it was hovered and focused.
  this.button1.States = new [] { "hovered", "focused" };

  // apply a custom state defined in a custom theme or theme mixing.
  this.panel1.States = new [] { "alert" };

In addition to setting this property directly, you can also manage it using the related methods:

  • AddState

  • RemoveState

  • HasState

TabIndex

Int32: Returns or sets the tab order of the control within its container.

TabStop

Boolean: Returns or sets whether the user can give the focus to this control using the TAB key and the Focusable property is set to true.

Tag

Object: Returns or sets the object that contains data about the control.

Text

String: Returns or sets the text associated with this control.

When AllowHtml is set to true, the text can contain HTML content. If the text contains new lines (CRLF) but doesn't contain HTML elements (at least one "<") all CRLF are automatically substituted with " ".

ToolTipText

String: Returns or sets the tooltip text to show for this control.

When using ToolTipText property you can only set the ToolTip text and cannot change the default ToolTip icon set in the theme. To change the ToolTip icon you can either create a custom theme, or a theme mixin, or use the ToolTip extender and the ToolTip property added by the extender. You can change the default ForeColor, AutomaticDelay, InitialDelay, AutoPopDelay, or enable HTML in ToolTipText by using a ToolTip extender also without setting the ToolTip property added by the extender.

Top

Int32: Returns or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.

UserData

Object: Returns a dynamic object that can be used to store custom data in relation to this control.

UseWaitCursor

Boolean: Returns or sets whether to use the wait cursor for the current control and all child controls.

ValidationCancelled

Boolean: Returns a flag indicating that the validation has been canceled.

Visible

Boolean: Returns or sets whether the control and all its child controls are displayed.

WheelDelta

Int32: Returns a value indicating the wheel delta from the last wheel event.

Width

Int32: Returns or sets the width of the control.

Methods

AddClientEventListener(name, script)

Adds a new listener script to the event name to the client widget.

Parameter
Type
Description

name

Name of the client event to attach the listener to.

script

JavaScript code to execute when the event occurs.

Returns: Int32. An integer id that you can use to remove the listener from the event using RemoveClientEventListener or to retrieve the listener script code using GetClientEventListener.

The script will execute in the browser when the event name occurs. You can attach multiple listeners to the same event.

AddCssClass(name)

Adds the CSS class name to the widget element. If the class already exists in the CssClass it's not added.

Parameter
Type
Description

name

Name of the css class to add.

Returns: String. The new value of the CssClass property.

AddState(state)

Adds the specified theme state to the widget.

Parameter
Type
Description

state

Name of the custom state to add to the widget.

Returns: String[]. The new list of states stored in the States property.

You can also assign a new array of states to the States property.

BeginInvoke(method, args)

Executes the specified delegate asynchronously.

Parameter
Type
Description

method

A delegate to a method that takes no parameters.

args

An optional array of objects to pass as arguments to the specified method.

Returns: IAsyncResult. An IAsyncResult that represents the result of the asynchronous call.

BringToFront()

Brings the control to the front of the z-order.

Call(function, args)

Runs the JavaScript function within the component's context in the browser.

Parameter
Type
Description

function

The name of the JavaScript function to execute.

args

The arguments to pass to the function.

Call(function, callback, args)

Runs the JavaScript function within the component's context in the browser and returns the value to the callback method.

Parameter
Type
Description

function

The name of the JavaScript function to execute.

callback

Asynchronous callback method that receives the return value.

args

The arguments to pass to the function.

CallAsync(function, args)

Asynchronously runs the JavaScript function within the component's context in the browser and returns an awaitable Task containing the value returned by the remote call.

Parameter
Type
Description

function

The name of the JavaScript function to execute.

args

The arguments to pass to the function.

Returns: Task<Object>. An awaitable Task that represents the asynchronous operation.

CenterToParent()

Centers the position of the control within the bounds of the parent.

CenterToParent(horizontal, vertical)

Centers the position of the control within the bounds of the parent either horizontally, vertically or both.

Parameter
Type
Description

horizontal

Center horizontally.

vertical

Center vertically.

Contains(control)

Indicates whether the specified control is a child of this control.

Parameter
Type
Description

control

The child to find.

Returns: Boolean. true if the specified control is a child of the control; otherwise, false.

CreateControl()

Creates and register this control and all its children.

DoDragDrop(data, allowedEffects)

Begins a drag-and-drop operation.

Parameter
Type
Description

data

The data to drag.

allowedEffects

One of the values.

Returns: DragDropEffects. A value from the DragDropEffects enumeration that represents the final effect that was performed during the drag-and-drop operation.

DoDragDrop(data, allowedEffects, imageSource)

Begins a drag-and-drop operation.

Parameter
Type
Description

data

The data to drag.

allowedEffects

One of the values.

imageSource

The name or URL for an image to use as the drag cursor.

Returns: DragDropEffects. A value from the DragDropEffects enumeration that represents the final effect that was performed during the drag-and-drop operation.

DoDragDrop(data, allowedEffects, imageSource, imageSize)

Begins a drag-and-drop operation.

Parameter
Type
Description

data

The data to drag.

allowedEffects

One of the values.

imageSource

The name or URL for an image to use as the drag cursor.

imageSize

The size of the drag image specified in imageSource.

Returns: DragDropEffects. A value from the DragDropEffects enumeration that represents the final effect that was performed during the drag-and-drop operation.

DoDragDrop(data, allowedEffects, image)

Begins a drag-and-drop operation.

Parameter
Type
Description

data

The data to drag.

allowedEffects

One of the values.

image

An to use as the drag cursor.

Returns: DragDropEffects. A value from the DragDropEffects enumeration that represents the final effect that was performed during the drag-and-drop operation.

DoDragDrop(data, allowedEffects, image, imageSize)

Begins a drag-and-drop operation.

Parameter
Type
Description

data

The data to drag.

allowedEffects

One of the values.

image

An to use as the drag cursor.

imageSize

The size of the drag image specified in image.

Returns: DragDropEffects. A value from the DragDropEffects enumeration that represents the final effect that was performed during the drag-and-drop operation.

Eval(javaScript)

Runs the javaScript code within the component's context in the browser.

Parameter
Type
Description

javaScript

The JavaScript code to run on the client.

Eval(javaScript, callback)

Runs the javaScript code within the component's context in the browser and returns the value to the callback method.

Parameter
Type
Description

javaScript

The JavaScript code to evaluate on the client.

callback

Asynchronous callback method that receives the return value.

EvalAsync(javaScript)

Asynchronously runs the javaScript code within the component's context in the browser and returns an awaitable Task that contains the value returned by the remote call.

Parameter
Type
Description

javaScript

The JavaScript code to evaluate on the client.

Returns: Task<Object>. An awaitable Task that represents the asynchronous operation.

FindForm()

Retrieves the form that the control is on.

Returns: Form.

FindPage()

Retrieves the page that the control is on.

Returns: Page.

Focus()

Sets input focus to the control.

Returns: Boolean. true if the input focus request was successful; otherwise, false.

GetChildAtPoint(pt, skipValue)

Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.

Parameter
Type
Description

pt

A that contains the coordinates where you want to look for a control. Coordinates are expressed relative to the upper-left corner of the control's client area.

skipValue

One of the values of , determining whether to ignore child controls of a certain type.

Returns: Control. The child Control at the specified coordinates.

GetChildAtPoint(pt)

Retrieves the child control that is located at the specified coordinates.

Parameter
Type
Description

pt

A that contains the coordinates where you want to look for a control. Coordinates are expressed relative to the upper-left corner of the control's client area.

Returns: Control. A Control that represents the control that is located at the specified point.

GetClientEventListener(id)

Returns the script associated to the listener identified by id .

Parameter
Type
Description

id

Id of the listener to retrieve the script for.

Returns: String. JavaScript associated with the listener.

GetClientEventListener(name)

Returns the scripts for all the listeners attached to the event name .

Parameter
Type
Description

name

Name of the event.

Returns: String[]. String array containing the scripts for the listeners attached to the event.

GetContainerControl()

Returns the next IContainerControl up the control's chain of parents.

Returns: IContainerControl. The parent IContainerControl.

GetNextControl(control, forward)

Retrieves the next control forward or back in the tab order of child controls.

Parameter
Type
Description

control

The to start the search with.

forward

true to search forward in the tab order; false to search backward.

Returns: Control. The next Control in the tab order.

GetStyle(flag)

Retrieves the value of the specified control style bit for the control.

Parameter
Type
Description

flag

The bit to return the value from.

Returns: Boolean. true if the specified control style bit is set to true; otherwise, false.

HasClientEventListener(name)

Checks whether the specified event name has any listener attached.

Parameter
Type
Description

name

Name of the client event to verify.

Returns: Boolean. True if the event name has any listener attached.

HasCssClass(name)

Returns true if the property CssClass contains the specified class name .

Parameter
Type
Description

name

Css class name to verify.

Returns: Boolean. True of the css class name is already included in CssClass.

HasState(state)

Checks whether the specified theme state is present in the States property.

Parameter
Type
Description

state

Name of the state to check.

Returns: Boolean. True if the widget already has the state .

Hide()

Conceals the control from the user.

Invalidate()

Causes the control to update the client side widget. When in design mode, causes the rendered control to update its entire surface in the designer.

Invalidate(invalidateChildren)

Causes the control to update the client side widget. When in design mode, causes the rendered control to update its entire surface in the designer.

Parameter
Type
Description

invalidateChildren

When true, invalidates all the children of the control.

Invoke(method)

Executes the specified delegate.

Parameter
Type
Description

method

A delegate that contains a method to be called in the control's thread context.

Returns: Object. The return value from the delegate being invoked, or null if the delegate has no return value.

Invoke(method, args)

Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.

Parameter
Type
Description

method

A delegate to a method that takes parameters of the same number and type that are contained in the args parameter.

args

An array of objects to pass as arguments to the specified method. This parameter can be null if the method takes no arguments.

Returns: Object. An Object that contains the return value from the delegate being invoked, or null if the delegate has no return value.

IsMnemonic(charCode, text)

Determines whether the specified character is the mnemonic character.

Parameter
Type
Description

charCode

The character to test.

text

The string to search.

Returns: Boolean. true if the charCode character is the mnemonic character; otherwise, false.

PointToClient(point)

Computes the location of the specified screen point into client coordinates.

Parameter
Type
Description

point

The screen coordinate to convert.

Returns: Point. A Point that represents the converted Point, point , in client coordinates.

PointToScreen(point)

Computes the location of the specified client point into screen coordinates.

Parameter
Type
Description

point

The client coordinate to convert.

Returns: Point. A Point that represents the converted Point, point , in screen coordinates.

RectangleToClient(rect)

Computes the size and location of the specified screen rectangle in client coordinates.

Parameter
Type
Description

rect

The screen coordinate to convert.

Returns: Rectangle. A Rectangle that represents the converted Rectangle, rect , in client coordinates.

RectangleToScreen(rect)

Computes the size and location of the specified client rectangle in screen coordinates.

Parameter
Type
Description

rect

The client coordinate to convert.

Returns: Rectangle. A Rectangle that represents the converted Rectangle, rect , in screen coordinates.

Refresh()

Forces the control to update corresponding client widget. When in DesignMode it forces a full redraw of the designer surface for this control, including the non-client areas such as the caption of forms or panels.

Refresh(refreshChildren)

Forces the control to update corresponding client widget. When in DesignMode it forces a full redraw of the designer surface for this control and optionally of its children, including the non-client areas such as the caption of forms or panels.

Parameter
Type
Description

refreshChildren

True to also refresh all the children of this control.

RemoveClientEventListener(id)

Detaches and removes the listener identified by id .

Parameter
Type
Description

id

Id of the listener to remove.

Returns: Boolean. True if the id specified a valid lister and it was removed; otherwise false if id is invalid.

RemoveClientEventListener(name)

Removes all the listeners attached to the event name .

Parameter
Type
Description

name

Name of the event.

Returns: Boolean. True if the event name has any listener that was removed.

RemoveCssClass(name)

Removes the specified css class name from the control's CssClass property.

Parameter
Type
Description

name

The css class name to remove.

Returns: String. The new value of the CssClass property.

RemoveState(state)

Removes the specified theme state from the widget.

Parameter
Type
Description

state

Name of the state to remove.

Returns: String[]. The new list of states stored in the States property.

You can also assign a new array of states to the States property.

ResetBindings()

Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

ResumeLayout()

Resumes layout logic.

ResumeLayout(performLayout)

Resumes layout logic, optionally forcing an immediate layout of all pending layout requests.

Parameter
Type
Description

performLayout

true to apply all pending layout requests; otherwise, false.

ScrollControlIntoView(alignX, alignY)

Scrolls the control into view in the container using the specified alignX and alignY preferences.

Parameter
Type
Description

alignX

Indicates the preference. The final location of the control depends on the scrollable range and the available space. Note that will not scroll the control to the center, but will instead scroll it into the closest visible location with the minimum movement.

alignY

Indicates the preference. The final location of the control depends on the scrollable range and the available space. Note that will not scroll the control to the middle, but will instead scroll it into the closest visible location with the minimum movement.

ScrollControlIntoView()

Scrolls the child control into view.

Select()

Activates a control.

SelectNextControl(control, forward, tabStopOnly, nested, wrap)

Activates the next control in the list according to the specified selection rules.

Parameter
Type
Description

control

The at which to start the search.

forward

true to move forward in the tab order; false to move backward in the tab order.

tabStopOnly

true to ignore the controls with the property set to false; otherwise, false.

nested

true to include nested (children of child controls) child controls; otherwise, false.

wrap

true to continue searching from the first control in the tab order after the last control has been reached; otherwise, false.

Returns: Boolean. true if a control was activated; otherwise, false.

SendToBack()

Sends the control to the back of the z-order.

SetBounds(x, y, width, height)

Sets the bounds of the control to the specified location and size.

Parameter
Type
Description

x

The new property value of the control.

y

The new property value of the control.

width

The new property value of the control.

height

The new property value of the control.

SetBounds(x, y, width, height, specified)

Sets the specified bounds of the control to the specified location and size.

Parameter
Type
Description

x

The new property value of the control.

y

The new property value of the control.

width

The new property value of the control.

height

The new property value of the control.

specified

A bitwise combination of the values. For any parameter not specified, the current value will be used.

Show()

Displays the control to the user.

SuspendLayout()

Suspends the layout logic for the control.

Update()

Causes the control to update the corresponding client side widget. When in design mode, causes the rendered control to update its entire surface in the designer.

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.

ValidateChildren(flags)

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

Parameter
Type
Description

flags

Returns: Boolean.

Events

Appear

EventHandler Fired after the control has been fully rendered on the client.

This is a "lazy" event. It fires only when there is an handler attached to it, otherwise the companion On{Name} protected method is not invoked. It's enough to attach to either one of Appear or Disappear to enable both events.

AutoSizeChanged

EventHandler Fired when the AutoSize property value changes.

BackColorChanged

EventHandler Fired when the value of the BackColor property changes.

BackgroundImageChanged

EventHandler Fired when the value of the BackgroundImage property changes.

BackgroundImageLayoutChanged

EventHandler Fired when the BackgroundImageLayout property changes.

BindingContextChanged

EventHandler Occurs when the value of the BindingContext property changes.

CausesValidationChanged

EventHandler Fired when the value of the CausesValidation property changes.

Click

EventHandler Fired when the control is clicked.

ClientSizeChanged

EventHandler Fired when the ClientSize property value changes.

ContextMenuChanged

EventHandler Fired when the value of the ContextMenu property changes.

ControlCreated

EventHandler Fired when a control is made visible the first time, fully created and sent to the client.

CursorChanged

EventHandler Fired when the value of the Cursor property changes.

Disappear

EventHandler Fired after the control is no longer visible on the client.

This is a "lazy" event. It fires only when there is an handler attached to it, otherwise the companion On{Name} protected method is not invoked. It's enough to attach to either one of Appear or Disappear to enable both events.

Disposed

EventHandler Fired when the component is disposed.

DockChanged

EventHandler Fired when the value of the Dock property changes.

DoubleClick

EventHandler Fired when the control is double-clicked.

DragDrop

DragEventHandler Fired when a drag-and-drop operation is completed.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

DragEnd

EventHandler Fired when a drag-drop operation is terminated either by a drop or canceled.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

DragEnter

DragEventHandler Fired when an object is dragged into the control's bounds.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

DragLeave

EventHandler Fired when an object is dragged out of the control's bounds.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

DragOver

DragEventHandler Fired when an object is dragged over the control's bounds.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

DragStart

EventHandler Fired when a drag-drop operation is started by the user.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

EnabledChanged

EventHandler Fired when the Enabled property value has changed.

EndMove

EventHandler Fired when a control is Movable and the user ends the move operation.

This event fires only when Movable is true and the user moves the widget on the client. It doesn't fire when the Location property changes.

EndResize

EventHandler Fired when a control has ResizableEdges and the user ends the resize operation.

This event fires only when the ResizableEdges has a value different than None and the user resizes the widget on the client. It doesn't fire when the Size of the control changes.

Enter

EventHandler Fired when the control gains the input focus.

FontChanged

EventHandler Fired when the Font property value changes.

ForeColorChanged

EventHandler Fired when the ForeColor property value changes.

HelpRequested

HelpEventHandler Fired when the user requests help for a control by pressing F1.

ImeModeChanged

EventHandler Fired when the ImeMode property has changed.

KeyDown

KeyEventHandler Fired when a key is pressed while the control has focus.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

KeyPress

KeyPressEventHandler Fired when a key is pressed while the control has focus.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

KeyUp

KeyEventHandler Fired when a key is released while the control has focus.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

Layout

LayoutEventHandler Fired when a control should reposition its child controls.

Leave

EventHandler Fired when the control loses the input focus.

LocationChanged

EventHandler Fired when the Location property value has changed.

LongTap

EventHandler Fired when a pointer holds on the screen.

MarginChanged

EventHandler Fired when the control's margin changes.

MouseCaptureChanged

EventHandler Fired when the control loses mouse capture.

MouseClick

MouseEventHandler Fired when the control is clicked by the mouse.

MouseDoubleClick

MouseEventHandler Fired when the control is double clicked by the mouse.

MouseDown

MouseEventHandler Fired when the mouse pointer is over the control and a mouse button is pressed.

MouseEnter

EventHandler Fired when the mouse pointer enters the control.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

MouseHover

EventHandler Fired when the mouse pointer rests on the control.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

MouseLeave

EventHandler Fired when the mouse pointer leaves the control.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

MouseMove

MouseEventHandler Fired when the mouse pointer is moved over the control.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

MouseUp

MouseEventHandler Fired when the mouse pointer is over the control and a mouse button is released.

MouseWheel

MouseEventHandler Fired when the mouse wheel moves while the control has focus.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

PaddingChanged

EventHandler Fired when the control's padding changes.

Paint

PaintEventHandler Fired when a UserPaint control needs to redraw itself.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

ParentChanged

EventHandler Fired when the Parent property value changes.

Pinch

PinchEventHandler Fired when two finger moved towards or away from each other. It contains the scaling factor of the pinch.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

PreviewKeyDown

PreviewKeyDownEventHandler Fired before the KeyDown event when a key is pressed while focus is on this control.

QueryContinueDrag

QueryContinueDragEventHandler Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

Resize

EventHandler Fired when the control is resized.

ResponsiveProfileChanged

ResponsiveProfileChangedEventHandler Fired when the active responsive profile is changed.

RightToLeftChanged

EventHandler Fired when the RightToLeft property value changes.

Rotate

RotateEventHandler Fired when two finger moved around a single point. It contains the angle of the rotation.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

SizeChanged

EventHandler Fired when the Size property value changes.

StartMove

EventHandler Fired when a control is Movable and the user begins the move operation.

This event fires only when Movable is true and the user begins moving the widget on the client.

StartResize

EventHandler Fired when a control has ResizableEdges and the user begins the resize operation.

This event fires only when the ResizableEdges has a value different than None and the user begins resizing the widget on the client.

StyleChanged

EventHandler Fired when the control style changed.

Swipe

SwipeEventHandler Fired when a pointer swipes over the screen.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

TabIndexChanged

EventHandler Fired when the TabIndex property value has changed.

TabStopChanged

EventHandler Fired when the value of the TabStop property changes.

Tap

EventHandler Fired when a pointer taps on the screen.

TextChanged

EventHandler Fired when the Text property value changes.

TouchCancel

TouchEventHandler Fired when a touch point has been disrupted in an implementation-specific manner (for example, too many touch points are created).

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

TouchEnd

TouchEventHandler Fired when a touch point is removed from the touch surface.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

TouchMove

TouchEventHandler Fired when a touch point is moved along the touch surface.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

TouchStart

TouchEventHandler Fired when a touch point is placed on the touch surface.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

Track

TrackEventHandler Fired when a pointer grabs an item and moves the pointer on it.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

Validated

EventHandler Fired when the control is finished validating.

Validating

CancelEventHandler Fired when the control is validating.

VisibleChanged

EventHandler Fired when the Visible property value changes.

WidgetEvent

WidgetEventHandler Fired when the control receives a custom event from the client.

JavaScript code can fire any event back to a control, including custom data, using:

  this.fireWidgetEvent("myevent", {x:1, y:2, name:'test'});

On the server side, the event name and event data are available in the WidgetEvent handler:

  
  private void control_WidgetEvent(object sender, WidgetEventArgs e) {
    
    switch (e.Type) {
    
      case "myevent":
        var data = e.Data;
        Alert.Show($"x={data.x}, y={data.y}, name={data.name}");
        break;
    }
  }

Inherited By

Name
Description

UI implementation for the FileDialog class.

UI implementation for the FolderDialog class.

Displays data in a customizable list format.

Used by the control to display data at run time.

Represents a shape control. Displays an element a border in any of the four sides.

Represents a panel that dynamically arranges its child controls.

Represents a spinner control that displays values.

Represents a spacer control. It can be used to add a space between controls in a layout panel. It is not rendered on the client.

Represents a data field that displays a list of selectable and removable tags. The control recognizes tags as the user types and adds in front of the editable field.

Displays child controls vertically or horizontally in a scrollable container.

Represents the navigation and manipulation user interface (UI) for controls that are bound to a data source.

Represents a button control.

Implements the basic functionality common to button controls.

Represents a check box control.

Displays a in which a check box is displayed to the left of each item.

Represents a combo box control.

Provides focus-management functionality for controls that can function as a container for other controls.

Represents a control that allows the user to select or type a date and a time.

Represents a spinner control that displays string values.

Represents a panel that dynamically arranges its children horizontally or vertically in automatic rows or columns.

Represents a window or dialog box that makes up an application's user interface.

Represents a Wisej control that displays a frame around a group of controls with an optional caption.

Represents a label control.

Represents an hyper-link control.

Represents a control to display a list of items.

Provides a common implementation of members for the and classes.

Uses a mask to distinguish between proper and improper user input.

Represents the container for multiple-document interface (MDI) child forms.

Represents a control that enables the user to select a date using a visual monthly calendar display.

Represents a spinner control that displays numeric values.

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.

Represents a collapsible panel with an optional header that contains a group of controls.

Represents an image control.

Represents a progress control that displays a value visually as a filled bar.

Enables the user to select a single option from a group of choices when paired with other controls.

Defines a base class for controls that support auto-scrolling behavior.

Represents an horizontal scroll bar.

Represents a vertical scroll bar.

Implements the basic functionality of a scroll bar control.

Represents a control consisting of a movable bar that divides a container's display area into two resizable panels.

Creates a panel that is associated with a .

Displays information to the user in a about the object being viewed, the object's components, or the object's operation.

Manages a related set of pages.

Represents a panel that dynamically lays out its contents in a grid composed of rows and columns.

Represents a single tab page in a .

Represents a text box control that allows the user to enter any value.

Implements the basic functionality required by text controls.

Enables the user to choose between a range of values by sliding a small bar along another bar.

Implements the basic functionality required by a spin box (also known as an up-down control).

Provides an empty control that can be used to create other controls.

Represents a web browser control that enables the user to navigate web pages inside a form or a page.

Represents a control that can be hosted in a .

Represents a control that can be hosted in a .

Represents a control that can be hosted in a cell.

Represents a control that can be hosted in a .

Represents a control that can be hosted in a cell when the cell's is set to .

Represents a data grid control.

Represents a desktop container that can host floating windows.

Displays collapsible set of panels for presenting information in a limited amount of space.

Represents a panel in a control.

Represents a control that can host ASP.NET or MVC pages within a Wisej application.

Represents the HTML5 canvas element.

Represents a control that can display flash applications.

Represents a control that displays any HTML file and a corresponding CSS style sheet as embedded HTML.

Represents a control that displays any HTML file in an IFrame element.

Represents a line control.

The TreeViewComboBox control represents a control with a as the drop down panel.

Base implementation for media controls.

Represents a control that displays a video file.

Represents a control that plays an audio file.

Represents a control that can display a pdf document in the browser either using the native pdf viewer, the pdf.js viewer, Google docs, or a custom viewer.

Represents a split button control.

The TreeViewComboBox control represents a control with a as the drop down panel.

Represent an upload widget. Allows users to selected one or more files and upload them to the server.

The UserComboBox control represents a control with a custom panel that drops down when the user clicks the down arrow.

Provides an popup container that can be attached to other controls.

Provides a generic widget that can use most third party javascript widgets.

Represents a list view control, which displays a collection of items that can be displayed using one of four different views.

Represents a menu bar component.

Provides a user interface for browsing the properties of an object.

Represents a toolbar component.

Displays a hierarchical collection of labeled items, each represented by a .

Implements

Name
Description

Bindable components implement this interface.

All wisej components implement this interface.

All wisej controls derived from the class must implement this interface.

Allows an object to serialize itself.

String
String
String
String
Delegate
Object[]
String
Object[]
String
Action<Object>
Object[]
String
Object[]
Boolean
Boolean
Control
Control
Object
DragDropEffects
DragDropEffects
Object
DragDropEffects
DragDropEffects
String
Object
DragDropEffects
DragDropEffects
String
Size
Object
DragDropEffects
DragDropEffects
Image
Image
Object
DragDropEffects
DragDropEffects
Image
Image
Size
String
String
Action<Object>
String
Point
Point
GetChildAtPointSkip
GetChildAtPointSkip
Point
Point
Int32
String
Control
Control
Boolean
ControlStyles
ControlStyles
String
String
String
Boolean
Delegate
Delegate
Object[]
Char
String
Point
Point
Point
Point
Rectangle
Rectangle
Rectangle
Rectangle
Boolean
Int32
String
String
String
Boolean
HorizontalAlignment
HorizontalAlignment
Center
VerticalAlignment
VerticalAlignment
Middle
Control
Control
Boolean
Boolean
TabStop
Boolean
Boolean
Int32
Left
Int32
Top
Int32
Width
Int32
Height
Int32
Left
Int32
Top
Int32
Width
Int32
Height
BoundsSpecified
BoundsSpecified
ValidationConstraints
FileDialogUI
FolderBrowserDialogUI
DataRepeater
DataRepeaterItem
DataRepeater
Shape
FlexLayoutPanel
TimeUpDown
TimeSpan
Spacer
TagTextBox
SlideBar
BindingNavigator
Button
ButtonBase
CheckBox
CheckedListBox
ListBox
ComboBox
ContainerControl
DateTimePicker
DomainUpDown
FlowLayoutPanel
Form
GroupBox
Label
LinkLabel
ListBox
ListControl
ListBox
ComboBox
MaskedTextBox
MdiClient
MonthCalendar
NumericUpDown
Page
Panel
PictureBox
ProgressBar
RadioButton
RadioButton
ScrollableControl
HScrollBar
VScrollBar
ScrollBar
SplitContainer
SplitterPanel
SplitContainer
StatusBar
TabControl
TabPage
TableLayoutPanel
TabPage
TabControl
TextBox
TextBoxBase
TrackBar
UpDownBase
UserControl
WebBrowser
DataGridViewComboBoxEditingControl
ComboBox
DataGridViewComboBoxCell
DataGridViewDateTimePickerEditingControl
DateTimePicker
DataGridViewDateTimePickerCell
DataGridViewMaskedTextBoxEditingControl
MaskedTextBox
DataGridViewMaskedTextBoxCell
DataGridViewNumericUpDownEditingControl
NumericUpDown
DataGridViewNumericUpDownCell
DataGridViewTextBoxEditingControl
TextBox
DataGridViewTextBoxCell
WrapMode
False
DataGridView
Desktop
Accordion
AccordionPanel
AccordionPanel
Accordion
AspNetPanel
Canvas
FlashPlayer
FlashPlayer
HtmlPanel
IFramePanel
Line
ListViewComboBox
UserComboBox
ListView
Media
Video
Video
Audio
Audio
PdfViewer
PdfViewer
SplitButton
TreeViewComboBox
UserComboBox
TreeView
Upload
UserComboBox
ComboBox
UserPopup
Widget
ListView
MenuBar
PropertyGrid
ToolBar
TreeView
TreeNode
IBindableComponent
IWisejComponent
IWisejControl
Control
IWisejSerializable