Infragistics2.Win.Misc.v6.3 Role class for the controls in the Infragistics.Win.Misc assembly (which this class is part of). Used by the associated to determine which instances should be cached. An array of strings containing the names of the role names that should be cached. Overridden. Class used by the app styling infrastructure that provides the role and component role defitions used by the assembly.

Note: A parameterless constructor is required for all derived classes.

 Returns an array of objects that define the roles provided by an assembly. Returns an array of objects that define the component roles provided by an assembly. Base role for UltraButton and UltraDropDownButton UI roles. UI role for the UltraButton. UI role for the UltraButton that's default button on the form (usually highlighted with border). Main UI role for the UltraDropDownButton control. UI role for the main button of the UltraDropDownButton. UI role for the split button (the one that drops down the drop down) of the UltraDropDownButton. Main UI role for the UltraExpandableGroupBox control. Main UI role for the UltraFormattedLinkLabel control. Main UI role for the UltraGroupBox control. UltraGroupBox header. UltraGroupBox header that's horizontal (either on top or bottom of the group-box). UltraGroupBox header that's on top of the group-box. UltraGroupBox header that's on bottom of the group-box. UltraGroupBox header that's vertical (either on left or right of the group-box). UltraGroupBox header that's left of the group-box. UltraGroupBox header that's right of the group-box. UltraGroupBox content area. Expansion indicator of the group-box. Base role for UltraLabel and UltraFormattedLinkLabel UI roles. Main UI role for the UltraLabel control. Base role for UltraPrintPreviewControl and UltraPrintPreviewThumbnail UI roles. Main UI role for the UltraPrintPreviewControl control. Main UI role for the UltraPrintPreviewThumbnail control. The element that displays the preview pages. The element that displays the page number inside the UltraPrintPreviewControl. The element that displays the preview of a single page. This role is associated with the shadow of a print preview page. It's simply a thin dark strip that emulates the shadow of the preview page. The box (typically outlined with red solid border) in the print preview thumbnail control that indicates the part of the page(s) currently being displayed in the associated print preview control. The print preview ruler area. The print preview ruler area intersection. The print preview ruler. UltraFormattedTextEditor main role. Abstract base control class for controls that automatically size based on their contents.

The AutoSizeControlBase class is an abstract base class for a control that will size based on its contents, which is usually the image and text. The property will determine if autosizing is enabled. When set to true, the control will be sized based on the .

 Abstract base control class

The ControlBase class is an abstract base control class for a basic ultracontrol that supports displaying image and text. The class exposes some common appearance properties as well as some properties that control the display of the text.

 Default constructor Determines if the collection needs to be serialized. Clears the collection Indicates whether the property contains data that needs to be serialized. Returns true if the property needs to be serialized.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

 Resets the property to its default value.

Use this method to reset the property. If the property was set to an Appearance from the Appearances collection, the properties on the object in the collection will remain the same but the property will no longer be attached to that . To reset the properties of the associated Appearance object, the method of the Appearance object itself should be invoked instead.

 Indicates whether the property contains data that needs to be serialized. Returns true if the property needs to be serialized.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

 Resets the property to its default value.

Use this method to reset the property. If the property was set to an Appearance from the Appearances collection, the properties on the object in the collection will remain the same but the property will no longer be attached to that . To reset the properties of the associated Appearance object, the method of the Appearance object itself should be invoked instead.

 Indicates if the property needs to be serialized True if the property differs from the default value Resets the value of the property to its default value

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

 Resets the property to its default value Indicates if the property should be serialized. True if the property value differs from the default value Invoked when a property on a subobject has changed. Information about the property change Use to notify the user when a property of the control has changed. Event arguments describing the property change notification Resolves the appearance for the control Appearance structure to update Appearance properties to resolve Resolves any remaining appearance settings for the control that have not been specified by the appearance properties. Appearance structure to update Appearance properties to resolve Invoked when the text of the control changes Event arguments Returns the color map used to remap colors in the images Image property returned from the resolved Appearance data A color map array of colors to remap or null Invoked when the mouse enters the bounds of the control Invoked when the mouse leaves the bounds of the control Handles disposing the control's resources. Boolean indicating if managed and unmanaged resources should be released. Overrides OnChangeUICues. Overridden. Called when the app-style changes. Overriden. This property is obsoleted. Please use object's BackColor property instead. Overriden. The BackgroundImage property does not affect the control Overiden. The ForeColor for the control does not affect the control Event handler for the SubObjectPropChange event of derived objects Gets/sets the associated imagelist control.

The ImageList is used to obtain the images to be displayed by the control when the Image property of the Appearance objects is set to an numeric value.

 Returns a collection of user created Appearance objects. Gets/sets the default appearance for the control. Indicates whether an object has been created. Returns true when the Appearance object for the property has been created.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets/sets the appearance for the control when the mouse is over the client area of the control Indicates whether an object has been created. Returns true when the Appearance object for the property has been created.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets/sets if the hot track appearance is used when the mouse is over the control. Specifies if the hot track appearance is used when the mouse is over the control. Gets/sets if the text is wrapped when there is not enough room to display the text. Gets/sets the size of the image displayed by the control Indicates how mnemonics are displayed by the control Gets or sets the text associated with this control. Gets/sets the color displayed as transparent in a image.

When set to a color other than Color.Transparent (the default), all occurrences of the color in the image will be made transparent.

If an image is supplied by setting an Appearance.Image property to an Imagelist index, the ImageLists TransparentColor property is looked at first. If that property is set to Color.TransparentColor, then the component's ImageTransparentColor is used. If it is set to Color.TransparentColor, then no color masking is done.

If an image is supplied by setting the Appearance.Image property to an image, the component's ImageTransparentColor is used. If it is set to Color.TransparentColor, then no color masking is done.

 Gets/sets whether mnemonics are displayed and processed.

When UseMnemonic is set to true, which is the default value, a character preceeded by a single ampersand will be displayed with an underline beneath it. That character is treated as an access key so that pressing ALT + the mnemonic character will cause the control to take an action. In the case, of a label, focus is forwarded to the next control.

 Gets/sets the amount of space between the contents (image and text) and borders. Indicates if the mouse is over a hot track area of the control For internal use only. Used for serializing out the BackColor property value. This is strictly for backward compatibility. Returns the default resolved value for UseHotTracking. Returns the component associated with the control Default constructor Invoked when the preferred size for the control should be calculated Invoked when the size or position of the control changes. Left coordinate Top coordinate Width Height Type of change Adjusts the control size to take into account the auto size. Invoked when the control is first created. Invoked when the text of the control changes Event arguments Use to notify the user when a property of the control has changed. Event arguments describing the property change notification Used to notify the control that it may resume rendering. True to invalidate the control and dirty the child elements; otherwise false. Returns the width available for displaying the image and text contents. Used to determine the preferred size for the control Proposed size The preferred size of the control Overridden. Gets/sets if the control is automatically sized.

The AutoSize property is used to determine if the control should automatically size based on its contents. When set to true, the control will be sized based on the .

 Returns the size need to display the image and the text - does not take into consideration borders or angles. Indicates whether space should be left for an image shadow. Indicates whether the width may be changed Base designer class for controls derived from GetTextBaseLine Overrides UltraControlDesigner GetTextBaseLine DefaultableInteger Determines the allowed selection behavior and sizing behavior for the control. Represents a standard windows button control.

The UltraButton is a standard windows button control and may be clicked using the mouse or keyboard (using the SPACE or ENTER keys).

Set the AcceptButton or CancelButton property of a Form to the button to allow the click event to be invoked using the ENTER or ESC keys respectively even if the button does not have focus.

When the form containing the UltraButton is displayed using the form's ShowDialog method, the property of the button may be used to specify the return value of the ShowDialog method.

The UltraButton has much of the same functionality as the inbox Button control with some additional features including the ability to fire the click event repeatedly while the button is pressed () and the ability to be displayed with non-rectangular shapes (). The default appearance of the button can be modified using the property. The can be used to adjust the appearance of the button when the mouse is positioned over the button when is set to true. The affects the appearance of the button when the button is pressed.

Note If the control that has focus accepts and processes the ENTER or ESC key, the UltraButton will not process it.

Note If the operating system supports themes and is true, the appearance of the control will be rendered using those these and will not use the colors specified in the associated appearance properties.

 Implements the basic functionality common to button controls.

This class implements the basic functionality for an autosize button control.

Set the AcceptButton or CancelButton property of a Form to the button to allow the click event to be invoked using the ENTER or ESC keys respectively even if the button does not have focus.

When the form containing the button is displayed using the form's ShowDialog method, the property of the button may be used to specify the return value of the ShowDialog method.

The class includes a number of properties to determine the appearance of the button. For example, the determines the appearance (color, image, etc.) when the button has been pressed. The property is used to determine the border style for the button. The is used to prevent the focus rectangle from being rendered when the control has focus. The property determines whether the button will be rendered with an additional border when it is the default button ().

The class also includes properties to affect the behavior of the control. For example, the button determines whether the button will receive focus when it is clicked.

Note When a button or other control does not receive focus, regardless of the CausesValidation property, the control with focus will not have its Validating/Validated events fired. These events are controlled and invoked by the base .Net control classes and are not invoked until the control loses focus, the container's Validate method is invoked, etc.

 Initializes a new . Indicates whether the property contains data that needs to be serialized. Returns true if the property needs to be serialized.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

 Resets the property to its default value.

Use this method to reset the property. If the property was set to an Appearance from the Appearances collection, the properties on the object in the collection will remain the same but the property will no longer be attached to that . To reset the properties of the associated Appearance object, the method of the Appearance object itself should be invoked instead.

 Invoked when the preferred size for the control should be calculated Returns the width available for displaying the image and text contents. Resolves the appearance for the control State of the button Appearance structure to update Appearance properties to resolve Invoked when a property on a subobject has changed. Information about the property change Invoked when a mnemonic has been pressed. Character to process True if the character was processed as a mnemonic of the control. Invoked after the key down event has fired for the control. Key event arguments Invoked after the key up event has fired for the control. Key event arguments Handles disposing the control's resources. Boolean indicating if managed and unmanaged resources should be released. Invoked when a key is pressed while the control has focus. Key event arguments Invoked when a key is released while the control has focus. Key event arguments Invoked when the control receives focus Event arguments Invoked when the button has been clicked. Event arguments for the event Invokes the control's click event.

This method can be called to generate a event for the control.

 Invoked when the button becomes or is no longer the Default button on the form. New default state

The button class is notified by the .net framework via the IButtonControl interface when it becomes the default button. This allows the button to modify its appearance to indicate its changed state. When the button is the default button, it will show an extra outline around the border of the control. This appearance change can be prevented using the property.

 Gets/sets the style of the button.

Note When the operating system supports themes and the property is set to true, the ButtonStyle will not be used since the control's appearance will be rendered using the system's themes.

 Returns the actual button style used to render the button.

This property returns the actual style of the button used. If the SupportThemes property is left to the default value of true and the operating system supports themed rendering, the control will use the 'Button' style regardless of what the property is set to.

Gets/sets the appearance for the button when the button is pressed down.

The PressedAppearance is used during the resolution of the button's appearance when the button is pressed down. The appearance can be used to specify a different color or image for the button when it is pressed.

 Indicates whether an object has been created. Returns true when the Appearance object for the property has been created.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets/sets whether the control takes focus.

The AcceptsFocus property is used to determine whether the button can receive focus. By default, this property is set to true so that the control can accept focus and be clicked using the keyboard. When set to false, the control will not be able to be navigated to using the mouse or keyboard.

Note When a button or other control does not receive focus, regardless of the CausesValidation property, the control with focus will not have its Validating/Validated events fired. These events are controlled and invoked by the base .Net control classes and are not invoked until the control loses focus, the container's Validate method is invoked, etc.

 Gets/sets whether a focus rect is rendered around the button when the control has focus.

It is sometimes useful to allow the control to receive focus but to make so that it does not render the focus rectangle (the dotted line within the borders of the button). The ShowFocusRect property may be set to false to prevent the control from rendering the focus rectangle when the control receives focus. When set to true, its default value, the focus rectangle will be rendered when the control has the input focus.

 Indicates whether images should display a shadow. Readonly. Indicates if the button is the default button for the form

The button class is notified by the .net framework via the IButtonControl interface when it becomes the default button. This allows the button to modify its appearance to indicate its changed state. When the button is the default button, it will show an extra outline around the border of the control. This appearance change can be prevented using the property.

 Overriden. Determines the default ImeMode for the control.

Since the UltraLabel control does not receive focus and does not use the key messages, the default ImeMode is disabled.

 Determines the ImeMode for the control. Gets/sets whether an outline is rendered outside the button borders when the button is the default button.

When a button becomes the default button, it will render an extra border around the edge of the control. To prevent this behavior, set the ShowOutline property to false.

 Returns the default resolved value for UseHotTracking. DoubleClick event is not used for a button.

Double-clicking a button is not a recognized action and, as such, the DoubleClick event should not be used.

Gets/sets the value returned to the parent form when the button is clicked.

When the form containing the button is displayed using the form's ShowDialog method, the DialogResult property of the button may be used to specify the return value of the ShowDialog method.

 Initializes a new UltraButton

Initializes a new UltraButton control.

Invoked after the key down event has fired for the control. Key event arguments Invoked after the key up event has fired for the control. Key event arguments Resolves the appearance for the control Appearance structure to update Appearance properties to resolve

This method can be used to retrieve information about various appearance-related settings being used by an . The appearance data returned reflects the current state of the control, such as whether the button is hottracking, depressed, etc.

Invoked when the preferred size for the control should be calculated The preferred size for the control Invoked when the mouse is released over the button. Event arguments for the MouseUp event Invoked when the size of the button has changed. Invoked when the control loses focus. Event arguments Factory method used to create the component role that provides the style information for the control. Creates a new accessibility object for the control. A new for the control. Gets/sets if the click event will continue to fire as the mouse is held down over the button.

When AutoRepeat is set to true, the click event will be invoked when the SPACE key is first pressed or when the button is first pushed down. It will then wait for the delay specified by the before entering an auto-repeat mode. While in this mode, until the mouse button is released or the SPACE key is released, the event will be invoked after the has elasped.

Note When set to false, which is the default value, the click event will only occur when the button is released (by either releasing the mouse button that pressed the button or releasing the SPACE or ENTER key).

 Gets/sets the amount of time that elapses before the button enters mode.

For more information about how this property is used, refer to the remarks about the property.

Gets/sets the amount of time that elapses between each event as the mouse is held down over the button.

For more information about how this property is used, refer to the remarks about the property.

Returns the main UIElement for the control Gets/sets the image used to generate the shape for the control.

The ShapeImage property is used to create a non-rectangular shaped button. The image specified for this property is used to create the region for the button control as well as being used to render the borders of the button. The color in the lower left hand pixel of the image is used to determine which color will be "masked" out - that is, which color will determine the areas of the image that are considered transparent. All pixels that do not match this color are considered to be opaque and will make up the displayed area of the button.

Note When a ShapeImage is specified and is set to true, the control will be sized based on the size of the ShapeImage since it is not possible to size the button so that the contents (image and text) are visible within the non-transparent areas of the button.

 Returns the ImageRegion object that manages the creation of the region object based on the shape image. Returns the actual button style used to render the button.

When the property is set to Default, the default button style will be 'Button', which is a 2 pixel border appearing similar to that of a standard windows button.

 Returns the default size for the control. Displays the About dialog for the control.

This property is only used at design-time.

Return the license we cached inside the constructor The Accessible object for an UltraButton. Constructor Performs the default action associated with this accessible object. Retrieves the object that has the keyboard focus. An AccessibleObject that specifies the currently focused child. This method returns the calling object if the object itself is focused. Returns a null reference (Nothing in Visual Basic) if no object has focus. Retrieves the currently selected child. An AccessibleObject that represents the currently selected child. This method returns the calling object if the object itself is selected. Returns a null reference (Nothing in Visual Basic) if is no child is currently selected and the object itself does not have focus. Retrieves the child object at the specified screen coordinates. The horizontal screen coordinate. The vertical screen coordinate. An AccessibleObject that represents the child object at the given screen coordinates. This method returns the calling object if the object itself is at the location specified. Returns a null reference (Nothing in Visual Basic) if no object is at the tested location. Navigates to another accessible object. One of the values. Gets a string that describes the default action of the object. Gets the role of this accessible object. Gets the state of this accessible object. Returns the associated UltraButton control. Main UIElement for the control Initializes a new UltraButtonControlUIElement UltraButton control owning the uielement Handles the creation and positioning of the child elements Overriden to do nothing and let IntializeGraphicsBackground handle the drawing. Returns the owning button control Returns the borderstyle used when rendering the button control Returns the associated with this element. Designer for the Gets the for this designer's UltraButton Defines a list of items to create a smart tag panel for the UltraButton Constructor Overrides CreateActionItems. Used by the SmartTag Panel. Used by the SmartTag Panel. Used by the SmartTag Panel. Used by the SmartTag Panel. AutoRepeat capable button class for rendering text and an image for the control Initializes a new UltraButtonUIElement Parent UIElement Handles the creation and positioning of the child elements Renders the themed version of the element Draw parameters True if the element could be rendered using the system themes Overriden. Prevent the base class from rendering the foreground of the button Draw parameters Initializes the appearance information for the uielement Appearance structure to update Appearance properties to resolve Invoked when the button has been clicked. True to prevent the base implementation from being invoked. Renders the focus rect within the button Draw parameters Resets the state of the button Overrides ButtonUIElementBase OnControlFocus - required because the framework forces focus when the UserMouseSetting is set to true resulting in validating events for other controls to be fired twice. Called when the button released Gets the button style for the element. Gets/sets the style of the button. Returns the contained UIElement that renders the image and text. Returns the owning button control Indicates if the button should display a focus rect. Returns the default backcolor for the button Returns the default forecolor for the button Returns the associated with this element. Determines whether the element can render an image background. Indicates if the button area is invalidated when the mouse enters and leaves the element. Common Controls Animation Control

The AnimationControl class is a wrapper for the Microsoft Common Controls Animation Control class. The control provides the ability to display AVIs without sound.

The property determines where the AVI is obtained. If set to AviFile, the is used to obtain the avi file when the avi will be played. Other members of the enum indicate that common system avi files should be used instead.

The and methods are used to start and stop the animation respectively. If the property is set to true, the animation will start playing when the handle for the control is created. Also, whenever the state of the animation changes, the event is invoked.

Note Since the class overrides members of the class that have link demands for unmanaged code rights, such as the WndProc and CreateParams, the class must have unmanaged code rights in order to be used. If these rights are not granted to the assembly and an instance of a derived instance of this control is sited on a form or usercontrol, a security exception is invoked when that form or usercontrol is about to load (i.e. during the jit of the containing class).

 Abstract base class for a Microsoft Common Control based control.

The CommonControlBase class is an abstract base class for creating a control wrapper for a Microsoft Common Control.

Note Since the class overrides members of the class that have link demands for unmanaged code rights, such as the WndProc and CreateParams, the class must have unmanaged code rights in order to be used. If these rights are not granted to the assembly and an instance of a derived instance of this control is sited on a form or usercontrol, a security exception is invoked when that form or usercontrol is about to load (i.e. during the jit of the containing class).

 Base constructor for common controls Invoked when the handle for the control is being created Invoked when a windows message is sent to the control Message structure containing information about the message Invoked when a message is reflected back from the containing control. By ref message structure Underlying reflected window message Invoked when a WM_COMMAND message is sent to the window procedure By reference message structure Notification code from the Invoked when a WM_NOTIFY message is sent to the window procedure By reference message structure Notification code from the NMHDR struct Invoked when a WM_PARENTNOTIFY message is sent to the window procedure By reference message structure Type of event notification True if the parent notify came from a reflected parent notify message Adds the specified style bit to the current window if already created. Bit to add Adds the specified extended style bit to the current window if already created. Bit to add Removes the specified style bit from the current window if already created Style bit to remove Removes the specified style bit from the current window if already created Style bit to remove Adds the bits style necessary to get the desired border style effect CreateParams instance to update Desired border style Adds the bits style necessary to get the desired border style effect Current window long style Current extended window style Desired border style Updates the border style of the control if the window handle exists Border style desired Used to recreate the handle if the window has already been created Returns the type of common control class that must be initialize to create the common control class. Paint event is not used for a microsoft common control. Overriden. The BackgroundImage property does not affect the control The Padding property is shadowed and hidden. It is not supported by this class. The BackgroundImageLayout property is shadowed and hidden. It is not supported by this class. Enumerations for the event notifications for a WM_PARENTNOTIFY message A child window is being created A child window is being destroyed Left mouse button depressed Right mouse button depressed Middle button depressed The first or second X button - Only under Windows 2000 and XP Initializes a new AnimationControl control Used to invoke the event Invoked when the handle for the control is created Event arguments Invoked when a WM_COMMAND message is sent to the window procedure By reference message structure Notification code from the Invoked when the control's resources should be released and the control is disposed. Used to recreate the handle if the window has already been created Invoked when a windows message is sent to the control Message structure containing information about the message Opens the specified avi animation file Filename of the animation to open. The property is updated with this value Opens the avi animation source specified by the property Stops playing the current animation Positions the animation at the specified frame Frame number Closes the currently opened animation file Plays the specified file File name of the avi animation to play. The property is updated with this value Number of times to play the animation. -1 indicates unlimited cycles Starting frame number. 0 is the first frame Ending frame number. -1 indicates the last frame Plays the specified file File name of the avi animation to play. The property is updated with this value Number of times to play the animation. -1 indicates unlimited cycles Plays the specified file File name of the avi animation to play. The property is updated with this value Plays the a specified number of times starting with a particular frame and ending with a particular frame. Number of times to play the animation. -1 indicates unlimited cycles Starting frame number. 0 is the first frame Ending frame number. -1 indicates the last frame Plays the a specified number of times Number of times to play the animation. -1 indicates unlimited cycles Plays the animation specified by the property Used to invoke the event when the animation starts or ends playing. The can be used to determine if the animation is currently playing. Event arguments Returns the type of common control class that must be initialize to create the common control class. Information used to create the control window Overriden. The Font property does not affect the Overiden. The ForeColor for the control does not affect the Overriden. Determines whether the control will receive focus when tabbing through the controls.

The AnimationControl does not receive focus so changing this property will not affect the control.

 Overriden. Determines the default ImeMode for the control.

Since the AnimationControl does not receive focus and does not use the key messages, the default ImeMode is disabled.

 Determines the ImeMode for the control. Text property - Not supported. Indicates if the animation is currently playing Indicates if an animation is currently opened Gets/sets the filename of the animation to play

The FileName property indicates the name of the avi file that should be played when the method is invoked. The property should be set to AviFile to use this property.

 Gets/sets whether the animation should automatically play

When set to true, the animation will automatically begin when the handle for the control is created.

 Gets/sets whether the animation is centered in the control

When set to true, the animation will be centered within the control bounds as the control is resized. When set to false, the animation is sited in the upper left corner of the client area of the control.

 Gets/sets whether the animation is played using a timer instead of a separate thread.

When set to true, the animation control will use a timer instead of a separate thread to handle changing the frames of the animation.

 Gets/sets whether the animation is displayed transparently Border style rendered around the control. Gets/sets the source of the animation

The AnimationSource determines which animation will be displayed. When set to AviFile, the animation is obtained from the file specified for the . Other settings are common operating system animations.

 Returns the default size for the control. Invoked when the animation starts and ends playing. Displays the About dialog for the control. Return the license we cached inside the constructor Designer for the Designer for the Static constructor Invoked after the control has been painted at design time. Paint event arguments Invoked before the message is routed to the control managed by the designer By ref message structure Used to filter and/or shadow properties that appear for the component at design time. Collection of properties Invoked when the designer is associated with the component Component managed by the designer Invoked when the designer is disposed True if managed resource should be disposed Returns a collection of verb actions that the control can take. Gets the for this designer's control/component. Provides DesignerActionItems for the SmartTag associated with the AnimationControl. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Type editor for selecting an AVI file Initializes the members of the file dialog. Open file dialog used to select the file. Enumeration of Common Control class types ListView and Header classes TreeView and ToolTips classes ToolBar, StatusBar, TrackBar and ToolTips classes Tab and ToolTips classes UpDown class Progress class HotKey class Animate class Win95 class Date classes - Month picker, Date picker, Time picker, up down ComboBoxEx Rebar/Coolbox control Internet classes Pager class Native Font Control Standard Classes Link class Enumerations of animation sources The specified file is used The system find folder animation The system find file animation The system find computer animation The system animation displayed when a file is copied The system animation displayed when a file is moved The system animation displayed when a file is moved to the recycle bin The system animation displayed when emptying the recycle bin The system animation displayed when a file is deleted Control UIElement for a control Initializes a new Handles the creation and positioning of the child elements Invoked when the mouse is pressed down on the control prior to passing the notification to the elements. MouseMessageInfo True if the dropdown is displayed to bypass processing the mouse down notification. Overriden to do nothing and let IntializeGraphicsBackground handle the drawing. Returns the borderstyle used when rendering the button control Returns the associated with this element. Dropdown button element for a split button. Initializes a new Parent element Draws the button borders UIElementDrawParams Renders the themed version of the element Draw parameters True if the element could be rendered using the system themes Overriden. Prevent the base class from rendering the foreground of the button Draw parameters Invoked when the state of the button changes. Overrides ButtonUIElementBase OnControlFocus - required because the framework forces focus when the UserMouseSetting is set to true resulting in validating events for other controls to be fired twice. Called when the mouse is pressed over the button Mouse event arguments True if left clicked over adjustable area of element. If not null on return will capture the mouse and forward all mouse messages to this element. If true then bypass default processing Initializes the appearance information for the uielement Appearance structure to update Appearance properties to resolve Gets the button style for the element. Returns flags indicating which borders will be drawn Returns the default backcolor for the button Returns the default forecolor for the button Returns the associated with this element. Indicates if the element supports accessibility Returns the accessible object representing this Owner. The Accessible object for a splitButtonDropDownUIElement. Constructor Navigates to another accessible object. One of the values. Gets the state of this accessible object. Main button element for a split button. Initializes a new Parent element Draws the button borders UIElementDrawParams Renders the themed version of the element Draw parameters True if the element could be rendered using the system themes Invoked when the state of the button changes. Overrides ButtonUIElementBase OnControlFocus - required because the framework forces focus when the UserMouseSetting is set to true resulting in validating events for other controls to be fired twice. Called when the mouse is pressed over the button Mouse event arguments True if left clicked over adjustable area of element. If not null on return will capture the mouse and forward all mouse messages to this element. If true then bypass default processing Initializes the appearance information for the uielement Appearance structure to update Appearance properties to resolve Handles the creation and positioning of the child elements Renders the focus rect within the button Draw parameters Called when the button released Resets the state of the button Overriden. Prevent the base class from rendering the foreground of the button Draw parameters Gets the button style for the element. Returns the contained UIElement that renders the image and text. Indicates if the button should display a focus rect. Returns the default backcolor for the button Returns the default forecolor for the button Returns the associated with this element. Indicates if the element supports accessibility Returns the accessible object representing this Owner. The Accessible object for a splitButtonUIElement. Constructor Navigates to another accessible object. One of the values. The accessible name for the splitButtonUIElement. Gets the state of this accessible object. Represents a button control that can display a dropdown window.

The UltraDropDownButton is a button control that can display a dropdown window.

When the is set to SplitButton, the control displays 2 buttons areas. The main button area acts as a standard button and will invoke the event when the button is released. An additional button with a dropdown arrow is displayed and can be used to display the dropdown window. When the Style is set to DropDownButtonOnly, only one button is displayed. When clicked, this button displays the dropdown window.

The property is used to specify the object that will provide the dropdown window. This could be any class that implements the interface including the or any PopupToolBase from an UltraToolbarsManager including its PopupMenuTool, PopupColorPickerTool, or PopupControlContainer tool.

When the dropdown window is about to be displayed, the event is invoked and may be cancelled to prevent the dropdown from being displayed. If the dropdown window is displayed, the event will be invoked after the dropdown window has been closed.

Set the AcceptButton or CancelButton property of a Form to the button to allow the click event to be invoked using the ENTER or ESC keys respectively even if the button does not have focus.

When the form containing the button is displayed using the form's ShowDialog method, the property of the button may be used to specify the return value of the ShowDialog method.

Note Even when the property is set to DropDownButtonOnly, the event will still be invoked if it is the AcceptButton or CancelButton for the form and the ENTER or ESC key is pressed.

 Initializes a new .

Initializes a new control.

Invoked when the preferred size for the control should be calculated Returns the width available for displaying the image and text contents. Invoked after the key down event has fired for the control. Key event arguments Invoked after the key up event has fired for the control. Key event arguments Used to display the dropdown window.

The DropDown method is used to display the dropdown window. If the button is already dropped down (see ), nothing further occurs. Otherwise, the event is invoked and if not cancelled, the dropdown window is displayed.

The control may also be dropped down by clicking on the dropdown button or via the DOWN arrow key when the control has focus.

 Used to close up the dropdown window.

The CloseUp method is used to close the dropdown window. Once the dropdown window has been closed, the event will be invoked.

 Overrides the control's determination of what is considered an input key. Key A boolean indicating if this key is an input key for the control. Called when the control is left Event args Factory method used to create the component role that provides the style information for the control. Used to invoke the event before the dropdown is displayed. Event arguments Used to invoke the event when the dropdown has been closed. Event arguments Creates a new accessibility object for the control. A new for the control. Creates an accessible object for the related object. The logically related objects (e.g. an OwnerUIElement etc.). A new object for the related object. Returns the main UIElement for the control Returns or sets the display style for the split button control.

The Style property is used to determine the display style for the control. When set to SplitButton, which is the default value, two buttons will be displayed. The main button that will display the image and text and will invoke the event when pressed. The secondary button, displayed on the right side of the button and displaying a dropdown arrow, will be used to display the dropdown window (see ). When set to DropDownButtonOnly only one button element is displayed. This button will display the image and text as well as a dropdown arrow. When pressed, the dropdown window will be displayed.

 This member supports the UltraDropDownButton infrastructure and is not intended to be used directly from your code. This member supports the UltraDropDownButton infrastructure and is not intended to be used directly from your code. Returns or sets the object that displays the dropdown window.

The PopupItem property specifies the object that will display the dropdown window. This can be any object that implements the interface including the or any PopupToolBase type tool from an UltraToolbarsManager component (e.g. PopupMenuTool, PopupColorPickerTool, PopupControlContainer type tools).

 Indicates whether the dropdown window is currently being displayed.

This property is only available at runtime.

Returns the default size for the control. Returns or sets whether the popup window will be aligned to the lower right edge of the dropdown button.

If this property is left to its default value then it is resolved based on whether the user's operating system is configured to display drop-down menus on the righthand side of the corresponding menu-bar item.

Returns the resolved setting determining whether the popup window will be aligned to the right edge of the dropdown button.

If this property is left to its default value then it is resolved based on whether the user's operating system is configured to display drop-down menus on the righthand side of the corresponding menu-bar item.

Invoked before the dropdown is displayed

The DroppingDown event is raised when the dropdown window (specified using the property) is about to be displayed. If the event is cancelled or there is nothing to dropdown, the dropdown will not be displayed.

 Invoked after the dropdown has closed up

The ClosedUp event is invoked after the dropdown window has been closed.

 Displays the About dialog for the control.

This property is only used at design-time.

Return the license we cached inside the constructor The Accessible object for an UltraDropDownButton. Constructor Retrieves the accessible child corresponding to the specified index. The zero-based index of the accessible child. An AccessibleObject that represents the accessible child corresponding to the specified index. Retrieves the number of children belonging to an accessible object. The number of children belonging to an accessible object. Retrieves the child object at the specified screen coordinates. The horizontal screen coordinate. The vertical screen coordinate. An AccessibleObject that represents the child object at the given screen coordinates. This method returns the calling object if the object itself is at the location specified. Returns a null reference (Nothing in Visual Basic) if no object is at the tested location. Navigates to another accessible object. One of the values. Gets the role of this accessible object. Gets the state of this accessible object. Designer for the control Prepares the designer to view, edit, and design the specified component. Component to be managed by the designer Disposes of resources used by the designer True if managed resources should be released. Used to filter and/or shadow properties that appear for the component at design time. Collection of properties Gets the for this designer's control/component. UITypeEditor for the Used to edit the value and convert the value as needed. ITypeDescriptorContext IServiceProvider Current value Edited value. Used to determine the type of UIEditor that will be displayed. ITypeDescriptorContext UITypeEditorEditStyle specifying the type of UIEditor. Provides DesignerActionItems for the SmartTag associated with the UltraDropDownButton. Constructor Overrides CreateActionItems. The list to populate. Used by the SmartTag Panel. Used by the SmartTag Panel. Used by SmartTag Panel. Used by the SmartTag Panel. Used by SmartTag Panel. Used by the SmartTag Panel. Enumeration of display styles for the control

The property uses this enumeration to determine whether the entire button should act as a dropdown button or whether the control should be separated into two areas - a main button that will invoke the Click event and a smaller section that can be used to display the dropdown.

 Displays a main button element and a separate dropdown button Only the dropdown button is displayed Enumeration used to determine the zoom level for the preview pages.

The ZoomMode enumeration is used by the and controls via their property.

 The value of the property is used to determine the zoom level. The value of the property is used to determine the zoom level but the number of columns in each row is based on the zoom up to a maximum specified by the . The value of the zoom is calculated based on the widest row of the current view. E.g. if the property is set to 1, the zoom will be calculated based on the widest page in the current view but if Columns is set to 2, the zoom will be calculated based on the widest set of pages in the current view. The value of the zoom is calculated based on the widest margin width in a row of the current view. The value of the zoom is calculated based on the extent required to show the largest row completely in the visible area. Enumeration of actions that determine how the responds to the mouse buttons.

The PreviewMouseAction is used by the of the to determine how to respond to clicks and drags using the left mouse button.

 The mouse buttons do not do anything The cursor is a hand and when the mouse is dragged up, the page is scrolled down. When the mouse is dragged down, the page is scrolled up. The mouse is dragged to create a selection rect where the selected area is copied to the clipboard. The mouse is used to zoom in or out. When the mouse is dragged up, the page is zoomed in; when dragged down, the page is zoomed out. The mouse is dragged to create a selection rect where the difference between the selected rect and the current view size determines the zoomed display. The mouse is dragged to create a selection rect where the selected area is zoomed into. Enumeration indicating where the page number for the print preview is displayed.

The PageNumberDisplayStyle enumeration is used by the and controls via their property.

 Default is resolved to None. A page number is positioned to the left of the row of preview pages. A page number is position below each preview page. No page number indicator is displayed. Nothing is dirty This information is dirtied if any font information is changed. This should be dirtied when the control is resized, borderstyle or scrollbars change or if the system scrollbar size changes. This needs to be dirtied whenever the preview rows/ layout need to be dirtied. This will be dirtied when the client size changes or the preview rows are generated. This will be dirtied when the client size changes or the preview rows are generated. This will be dirtied when the client size changes or the preview rows are generated. This represents a combination of the ScrollInfo and PreviewRows values. This will be dirtied when the font information for the ruler changes. All states Enumeration used to indicate where the view box will be displayed in the control pages.

The ViewBoxDisplayStyle enumeration is used with the property to determine which pages, if any, should display a viewbox. A view box is an area with the preview page of an that indicates what portion of that page is currently in view within its corresponding .

 The view box is displayed in each thumbnail page that is currently in view in the associated . The view box is displayed only in the of the associated . The view box is not displayed. Enumeration used to indicate where the view box may be dragged within a page.

The ViewBoxDisplayStyle enumeration is used with the property to determine if the end-user may drag the view box to change what portion of the page should be in view within the corresponding of an .

 The default drag mode. When the Control key is held down, RestrictWithinPage is used; otherwise Free is used. The view box is kept entirely within the page containing it. It cannot be dragged so that less of the view box is within the page. The view box may be dragged anywhere within the page. The view box cannot be dragged. Enumeration of ruler units The ruler unit will be either Inches or Centimeters based on the IsMetric of the current culture info. Inches Centimeters Millimeters Points Picas Pixels Enumeration indicating whether the vertical and horizontal rulers are displayed in a . Rulers are not displayed A vertical and horizontal ruler is displayed for the Event ids for event managing. LinkClicked event id. ParseError event id. ValueChanged event id. EditStateChanged event id. Has the same integer value as the last event id. Class for managing an events. It maintains an enabled flag for each event as well as a nested 'in progress' count and it exposes events for firing each event. Contructor. Initializes a new instance of . UltraFormattedTextEditorBase that this event manager will be asociated with. Returns true if the event is in progress (in progress count > 0 Returns true if the event is enabled Sets a specific event enabled or disabled Returns true if the event can be fired Returns the associated control. The associated UltraFormattedLinkLabel control. The main element for an (occupies the entire client area). The main element for an (occupies the entire client area). Overridden. Creates the child elements for the grid Performs the action and returns true if message was handled. true if shift key down true if control key down Overridden. Does nothing. Background is drawn by a descendant element. Overridden. Does nothing. Background is drawn by a descendant element. Returns the associated with this element. The padding to place around the value to display. The context that was passed into the method. (out) The padding to place around the value to display. A boolean indicating whether a meaningful value was returned. Returns the value that should be rendered. The context that was passed into the method. Resolves the appearance for an element. The context that was passed into the method. The appearance structure to initialize. The appearance properties to resolve. Enumeration of type describing the area of the embeddable element to which the appearance will be applied Boolean indicating whether the owner should apply its 'HotTrackingAppearance' A string that denotes which appearance to resolve. Applicable only when the 'area' parameter is set to Custom. True if the owner recognizes and supports the named appearance. Returns the color that is used as the transparent color for images displayed by the editor The context that was passed into the method. The color that is used as the transparent color for images displayed by the editor Returns the image list to be used by the editor's ValueList, or null The context that was passed into the method. An ImageList, or null if no ImageList exists If true is returned, the editor will enter edit mode on either MouseDown or MouseUp, depending on the nature of the editor The owner context The default implemenation returns true Returns the BorderStyle to be used by the editor's embeddable element The context that was passed into the method. The BorderStyle to be used by the editor's embeddable element Returns whether the text should be wrapped if it doesn't fit. The context that was passed into the method. A boolean indicating whether the text should be wrapped The default implementation calls the IsMultiLine method and returns its value The editor calls this method whenever any of its embeddable elements gets a mouse down. Returns the text rendering mode to use. Default implementation returns Default value. Returns whether the key is used by the owner. The EmbeddableUIElementBase-derived element True if the key is used by the owner (e.g. an arrorw or tab key used for internal navigation). Overridden. Returns the to be used by the scrollbars displayed by the embeddable editor. Context used to identify the object to reference A instance.

Note: This method is currently only used by the embeddable editor for the scrollbars displayed in the dropdown list. The default implementation returns null.

 Overridden. This method indicates whether editor buttons should always fire editor button events even if the editor is not in edit mode. Overridden. Returns whether "hot tracking" effects should be enabled The context that was passed into the method. The default implementation returns true. When one embeddable element is in edit mode, others might want to disable hot tracking effects; in that case, the owner should return false from this method. Returns true is the value is read-only The context that was passed into the method. A boolean indicating whether the value is read only The default implementation returns false. The editor calls this method whenever any of its embeddable elements gets a mouse down. Returns the DisplayStyle to be used by the embeddable element The context that was passed into the method. Overridden. Gets the spell checker A compoment that implements the inteface or null. interface or null. Overridden. Returns true as the FormattedTextEditor is always in edit mode. The EmbeddableEditorBase-derived instance True if the editor never leaves edit mode. The default implementation returns false. Returns whether the element should be drawn as if it is in its "active" state. The main element for an (occupies the entire client area). Interface that provides information to the designer about the UltraFormattedTextEditorBase. NOTE: This is for internal use only. Behavior and API this interface may change in the future. Returns the Text BaseLine for Snaplines in VS 2005 Control for displaying formatted text. It also has support for displaying hyper-links, images and horizontal lines. Embeddable editor class for displaying html links. It also allows editing the link. Constructor. Initializes a new instance of . overridden method that properly disposes of allocated resources Overridden. Fires KeyDown events. Overridden. Fires KeyUp events. Overridden. Fires KeyPress events. Returns true if the character should be sent directly to the control and not preprocessed, false otherwise. Returns true if the key is a valid input key for this control Called when a property or subobject's property value has changed. Used to determine the preferred size for the control Proposed size The preferred size of the control Factory method for creating the editor owner. Syncrhonizes the Appearance.BackColor with the BackColor property of the control. Checks to see if AutoSize needs serializing Resets the AutoSize to its default value Checks to see if WrapText is set to a non-default value. Resets the WrapText to its default value of True. Calculates the size required to fully display the contents. Calculates the size required to fully display the contents. Specifies the size constraints. If height is 0 and width is positive then the height will be calculated based on the specified width. Resolves the appearance for an element. The appearance structure to initialize. The appearance properties to resolve. A string that denotes which appearance to resolve. Possible values are "Link", "ActiveLink", "HotTrackedLink" and "VisitedLink". True if the owner recognizes and supports the named appearance. Resolves selected properties of the control's Appearance.

Use this method to retrieve the actual values that are being used to format the control. This method returns a value for all Appearance properties or only for specified ones, tracing up the Appearance hierarchy if necessary. You can combine the bit flags for this method to specify which properties should be resolved.

 The structure to contain the resolved apperance. Bit flags indictaing which properties to resolve. Reset border style Resets the property to its default value. Returns true if the property is set to a non-default value. Resets all appearance property values to their defaults Resets the property to its default value. Resets the property to its default value. Resets the property to its default value. Resets all property values to their defaults Resets all property values to their defaults Resets all property values to their defaults Resets all property values to their defaults Resets the property to its default value. Simulates user interaction with the control.

Invoke this method to simulate an action the user can perform.

Many actions are only appropriate in certain situations; if an action is inappropriate, it will not be performed.

You can use the property to determine the state of the control when the action is about to be performed.

See for a list of actions that can be performed.

 Returns true if this property is not set to a non-default value. Reset the property to its default value. Resets the property to its default value. Fires event. Fires ValueChanged event. Fires event. Returns true if this property is not set to its default value Returns true if the property is set to a non-default value. Returns true if the appearance has any non-default property values set. Returns true if the property is set to a non-default value. Returns true if the property is set to a non-default value. Returns true if the property is set to a non-default value. Returns true if the property is set to a non-default value. Returns true if the has any non-default property values set. Returns true if the has any non-default property values set. Returns true if the has any non-default property values set. Returns true if the has any non-default property values set. Returns true if property is set to a non-default value. Indicates whether the property needs to be serialized. A boolean indicating whether the property needs to be serialized. Factory method used to create the component role that provides the style information for the control. Overridden. Display the about dialog Return the license we cached inside the constructor Occurs when the user clicks a link. Fired when an error occurs parsing the value. This occurs when the formatted link editor encounters an invalid value.

This event is fired when the value specified to the formatted link editor has parsing errors.

Fired when the value changes. BackColor property is not supported. Use the property instead.

BackColor, ForeColor and BackGroundImage properties are not supported. Use the property instead to specify these settings.

ForeColor property is not supported. Use the property instead.

BackColor, ForeColor and BackGroundImage properties are not supported. Use the property instead to specify these settings.

BackgroundImage property is not supported. Use the property instead.

BackColor, ForeColor and BackGroundImage properties are not supported. Use the property instead to specify these settings.

Overrides the control's property to hide it so that the appearance can be used instead. Font property is not supported. Use the property instead.

The Fontproperty is not supported. Use the property instead to specify the font.

Returns the editor owner used by the control to provide information to the internal editor instance. Returns the internal editor, the editor used by the control. Indicates if the internal editor has been created. Returns the editor provided to other controls. Indicates if the internal editor has been created. Returns the event handler that notifies OnSubObjectPropChanged Appearance applied to cells of empty rows. Appearance applied to the link when it's activated (while the mouse is down on the link).

ActiveLinkAppearance is applied to the link when the user presses a mouse button on the link. This appearance is applied while the mouse button is pressed down. When the mouse button is depressed, this appearance ceases to be applied.

Appearance applied to a link when the mouse is hovered over it.

HotTrackLinkAppearance appearance is applied to a link when the user hovers mouse over it.

Appearance applied to the link when the link is previously visited.

VisitedLinkAppearance appearance is applied to links that are previously visited. The visited links are tracked using the .

Appearance applied links.

LinkAppearance is applied to the links that are displayed in the control.

Determines whether the size of the control is automatically adjusted to the size of the contents. The default is False.

If this property is set to True, the size of the control automatically adjusts to fit the contents. When False, the control's size remains the same until explicitly changed. The default is False.

Returns or sets the border style of the control.

You can use the property to specify the border color.

Gets or sets the padding around the text. Default is 1. Padding is the space between the text and the border of the control. Specifies whether to draw text antialiased. This property has effect only when drawing text using GDI+, which is the default text drawing mode. The object that enables, disables and controls firing of specific control events.

The event manager gives you a high degree of control over how the control invokes event procedures. You can use it to selectively enable and disable event procedures depending on the context of your application. You can also use the event manager to return information about the state of the control's events.

The event manager's methods are used to determine the enabled state of an event (), to selectively enable or disable events (), and to tell whether an event procedure is currently being processed (). There is also an property that you can check to quickly determine whether any events have been disabled by the event manager.

 Returns a static instance of VisitedLinksCollection that the link label uses as the default visited links manager. This property is read-only.

You can use the property to specify a custom visited links manager.

Specifies the visited links manager for managing visited links. Default value returned by this property is a static instance shared among all the link labels. Gets or sets the text, without any formatting information. Use the Value property to get and set the value with formatting information, including URL's.

Text property gets or sets the text being displayed, without any formatting information. To get or set the text with formatting, use the property. Also to get or set the URL, use the Value property.

Gets or sets the value to be displayed in the label.

Use the Value property to set the value that will be displayed by the control. Depending on the property settings, the set value will be interpreted differently. See property for more information.

Specifies whether the values displayed by this editor will be raw text, URL or formatted text. Default is Auto, which specifies that the values should be auto-detected. Specifies whether to show tool-tips specified in title attributes of the elements in formatted text values. The default value is true. Specifies if and when to underline the links.

By default the behavior is auto-detected from the MS Internet Explorer by reading settings from the registry. Use the UnderlineLinks property to explicitly set the behavior.

Gets/sets if the text is wrapped when there is not enough room to display the text. Default value is True. Returns the default size for the control. Specifies the base url for relative links and image sources. This can be a file path or an internet url.

You can specify relative sources for hyperlinks and images in the formatted text. The default behavior is to use the application's current path to resolve the url to access the associated resource. You can use the BaseURL property to control how relative URL's are resolved. Also note that the base URL can be set for all instances of this control in an application by setting the FormattedLinkEditor's static (shared) property.

Specifies if and when to display scrollbars. Determines the appearance of the scroll bars. Associated Control UIElement object The object that implements the IEmbeddableEditor interface (read-only) Resets the object to its default state. Returns true if the object needs to be serialized. Called when this object is Disposed of Called when another sub object that we are listening to notifies us that one of its properties has changed. Constructor. Initializes a new instance of . Factory method used to create the component role that provides the style information for the control. Overridden. Factory method for creating the editor owner. Simulates user interaction with the control.

Invoke this method to simulate an action the user can perform.

Many actions are only appropriate in certain situations; if an action is inappropriate, it will not be performed.

You can use the property to determine the state of the control when the action is about to be performed.

See for a list of actions that can be performed.

 Display the about dialog Return the license we cached inside the constructor Determines whether the control will receive focus when tabbing through the controls.

This property should not be used for the .

Overriden. Determines the default ImeMode for the control.

Since the UltraFormattedLinkLabel control does not receive focus and does not use the key messages, the default ImeMode is disabled.

 Determines the ImeMode for the control. Determines the ImeMode for the control. Associated Control UIElement object. Control for displaying and editing formatted text. It also has support for displaying hyper-links, images and horizontal lines.

See for more information.

Constructor. Initializes a new instance of . Factory method used to create the component role that provides the style information for the control. Overridden. Factory method for creating the editor owner. Overridden. Overridden. Overridden. Returns true if this property is not set to a non-default value. Reset the property to its default value. Returns true if this property is not set to a non-default value. Reset the property to its default value. Returns true if this property is not set to a non-default value. Reset the property to its default value. Fires event. Display the about dialog Return the license we cached inside the constructor Fired when state of the editor changes. for example when the SelectionStart or SelectionLength changes or undo/redo history changes etc...

This event is fired when the edit state of the formatted link editor changes. This event is only fired when the editor is in edit mode. Examples of changes that will lead to firing of this event are change in the SelectionStart, SelectionLength, Value, change in the formatting state (toggling of bold, italics etc...), change in undo/redo history etc....

Gives you the ability to reconfigure the way the control responds to user keystrokes.

The KeyActionMappings property provides access to the control's mechanism for handling keyboard input from users. All keystrokes for actions such as selection, navigation and editing are stored in a table-based system that you can examine and modify using this property. Through the KeyActionsMappings property, you can customize the keyboard layout of the control to match your own standards for application interactivity.

For example, if you wanted users to be able to navigate between cells by pressing the F8 key, you could add this behavior. You can specify the key code and any special modifier keys associated with an action, as well as determine whether a key mapping applies in a given context.

 Returns bit flags that indicate the current editing state of the control. The CurrentState property is used primarily in conjunction with the property and the method to return information about the state of the control with regards to user interaction. The setting of the CurrentState property indicates which object has focus in the control, whether the user has placed the control into edit mode, and other information such as whether a combo box is dropped down or whether a row is expanded. Associated Control UIElement object. Returns an object that exposes edit related properties and methods. Instances of this class are valid only when the associated formatted text editor is in edit mode. Specifies whether the user will be allowed to modify the contents of the control.

ReadOnly specifies whether the user will be allowed to modify the contents of the control. However note that the user will be allowed to enter the edit mode and select and copy part of the contents.

Specifies the display style of the editor control. Specifies the menu items that should be displayed in the context menu when in edit mode. NOTE: Some of the options require reference to Infragistics.Win.SupportDialogs assembly. You can set this property to control which context menu items get displayed in the editor when the user right-clicks on the control. Some of the options require that the application reference the Infragistics.Win.SupportDialogs assembly. This assembly provides dialogs used by these options. See for more information on which options require this assembly. Indicates whether the control is currently in edit mode. Available only at runtime. Specifies whether to hide the selection when the control doesn't have focus. The default value of this property true. Gets/sets the component that will perform spell checking on this control. Different types of borders that the UltraGroupBox and UltraExpandableGroupBox can display.

This enum is used by the BorderStyle property of the and controls.

The default border style for the ViewStyle being used. A 3D line on the header. Two parallel solid lines on the header. A solid line on the header. No border is drawn. Two parallel 3D lines, one on the header and the other on the side opposite the header. Two sets of two parallel solid lines, one on the header and the other on the side opposite the header. Two parallel solid lines, one on the header and the other on the side opposite the header. 90 degree corners with a 3D line. 90 degree corners with two solid parallel lines. 90 degree corners with an inset line. 90 degree corners with a raised line. 90 degree corners with a solid line. Curved corners with a solid line, similar to what is seen in Office 2003 applications and Visual Studio 2005. Settings for the location of the .

This enum is used by the ExpansionIndicator property of the control.

Default is resolved to Near. The distance between the expansion indicator and the upper left corner of the control is large, with respect to the HeaderPosition. An expansion indicator is not displayed. The distance between the expansion indicator and the upper left corner of the control is small, with respect to the HeaderPosition. This is the default value. Settings for the action performed when the header is clicked on.

This enum is used by the HeaderClickAction property of the control.

The default action performed when the header is clicked. No action is performed when the header is clicked. The expansion state of the is toggled when the header is clicked. Possible positions of the control’s caption relative to the header edge closest to the first character of the caption.

This enum is used by the CaptionAlignment property of the and controls.

Default is resolved to Near. The caption is centered within the header. The distance between the last character of the caption and the edge of the header closest to that character is small. The distance between the first character of the caption and the edge of the header closest to that character is small. Various edges of the control that the header can appear on and also whether the header appears inside, on, or outside the border.

This enum is used by the HeaderPosition property of the and controls.

Header appears in the default location, based on the ViewStyle of the control. Header appears on the upper edge of the control, on the border. Header appears on the upper edge of the control, within the border. Header appears on the upper edge of the control, outside of the border. Header appears on the right edge of the control, on the border. Header appears on the right edge of the control, within the border. Header appears on the right edge of the control, outside of the border. Header appears on the lower edge of the control, on the border. Header appears on the lower edge of the control, within the border. Header appears on the lower edge of the control, outside of the border. Header appears on the left edge of the control, on the border. Header appears on the left edge of the control, within the border. Header appears on the left edge of the control, outside of the border. Different ways that the caption can be drawn when it is vertical (i.e. when the header is positioned on the left or right edge).

This enum is used by the VerticalTextOrientation property of the and controls.

Vertical text is drawn with the default orientation, based on the HeaderPosition property. The first character of the text is below the last character of the text on the Y axis. The first character of the text is above the last character of the text on the Y axis. Preset color schemes.

This enum is used by the ViewStyle property of the and controls.

Default. Resolved to XP. The control is drawn with colors seen in Office 2000. The control is drawn with colors seen in Office 2003. The control is drawn with colors seen in Office2007. The control is drawn with colors seen in Visual Studio 2005. The control is drawn like the themed GroupBox seen in many modern applications. Used internally to manage the child controls of the .

The can only have one child control, an . This class ensures that this requirement is satisfied by overriding the and methods.

Creates an instance of this class. The UltraExpandableGroupBox which uses the newly created object. The whose Panel property will use the object being create by this constructor is passed as an argument. Do not call this method to add a control to the UltraExpandableGroupBox's collection of child controls. Add the control to the UltraExpandableGroupBoxPanel contained within the UltraExpandableGroupBox instead. For example: ultraExpandableGroupBox1.Panel.Controls.Add( someControl ) Must be a UltraExpandableGroupBoxPanel otherwise an ArgumentException is thrown.

This method is intended for internal use only.

Do not call this method to remove a control from the UltraExpandableGroupBox's collection of child controls. Remove the control from the UltraExpandableGroupBoxPanel contained within the UltraExpandableGroupBox instead. For example: ultraExpandableGroupBox1.Panel.Controls.Remove( someControl ) The control to remove.

This method is intended for internal use only.

GroupBoxContentAreaBackgroundUIElement represents the background of the content area in an .

This is the element responsible for rendering the background of the control's content area. It is a sibling of a and a child of a in the control's element hierarchy.

Creates a new GroupBoxContentAreaBackgroundUIElement. The element which represents the content area of the control.

This is the element responsible for rendering the background of the control's content area. It is a sibling of a and a child of a in the control's element hierarchy.

Initializes the Appearance object associated with the content area's background. Gets the clip region for the content area background.

This override will trim off the edges needed for a rounded border, if the control's border style is 'Rounded'.

Returns true so that the overridden Region property will be used while rendering. GroupBoxContentAreaBorderUIElement represents the border of the content area in an .

This is the element responsible for rendering the border of the control's content area. It is a sibling of a and a child of a in the control's element hierarchy.

Creates a new GroupBoxContentAreaBorderUIElement. The element which represents the content area of the control.

This is the element responsible for rendering the border of the control's content area. It is a sibling of a and a child of a in the control's element hierarchy.

Does nothing. Does nothing. Draws the borders of the content area. Initializes the Appearance object associated with the content area's border. Gets/sets a object which represents the sides of the element that a border will be drawn on. Gets the object used when rendering this element. If the header is on the border of the content area, the will exclude any of the child elements of the . Returns true so that the overridden Region property will be used while rendering. GroupBoxContentAreaUIElement represents the area of the which contains the child controls. This element manages the and elements, which render the background and border of the content area. Constructor Does nothing. Initializes the Appearance object associated with the content area. Positions the child elements of the content area. Gets the UltraGroupBox control associated with the content area. Returns the associated with this element. The GroupBoxExpansionIndicator is the element in the which allows the end-user to expand and collapse the content area. Constructor. Draws the focus rectangle on the expansion indicator. Overrides DrawTheme. Initializes the appearance of the expansion indicator. Overrides OnMouseDown. Called when the mouse up message is received over the element. Mouse event arguments Positions the image element. Returns the style of button that the expansion indicator uses. Gets the Region associated with the expanion indicator. Returns the associated with this element. Returns true if the expansion indicator should show a focus rectangle when the has input focus. This class represents the header area of the . The header contains the caption, expansion indicator (only in the ), and an optional image. It can be positioned on any of the four sides of the control, with horizontal or vertical alignment. Constructor Draws the back color of the header. Draws the borders of the header. A referece to the UIElementDrawParams used when drawing the borders of the header. Initializes the Appearance object used by the header. Overrides OnMouseDown. Invoked when the mouse cursor enters the header element. Invoked when the mouse cursor leaves the header element. Called when the mouse up message is received over the element. Mouse event arguments Arranges the child elements of the header. Gets the style of border used by the header of the control. Gets the UltraGroupBox control associated with the header. Gets the clip region of the header. Returns the associated with this element. Allows the Region property to take effect. Gets the which represents the area in which the caption and image are located. Gets the which represents the area in the header of the that allows the user to expand and collapse the control. Note, this property will always return null (Nothing) if the control is an . Returns true if the control exists in the designer. The UltraExpandableGroupBox represents a standard Windows GroupBox with the ability to expand and collapse.

The UltraExpandableGroupBox has all of the features of the plus the ability for it's content area to be expanded and collapsed by the end-user or programmatically. The interface provided for the end-user to toggle the expansion state is a , which is located in the header of the control. The header is the part of the control which contains the caption, an optional image, and the expansion indicator.

 The UltraGroupBox represents a standard Windows GroupBox with a high degree of flexibility.

It can be configured so that the header (which includes the caption and optional image) appears on any of its four sides. By default the header is positioned on the border but it can also be outside of the border and inside of it as well.

Initializes a new UltraGroupBox.

Initializes a new UltraGroupBox.

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

 Releases any resources used by the control. True if we are disposing. Overrides OnEnabledChanged so that the UIElement hierarchy can be verified. Handles the FontChanged event. Handles the Layout event. Called when a property has changed on a sub object.

OnPropertyChanged will also be called.

 Called when a property or subobject's property value has changed. Invoked when a mnemonic has been pressed. Character to process True if the character was processed as a mnemonic of the control. Used internally by the control. This method is not intended for external use. Forces the to be invalidated. Factory method used to create the component role that provides the style information for the control. Overriden to redraw controls when the Office2007 ColorScheme changes. Overridden. Syncrhonizes the Appearance.BackColor with the BackColor property of the control. Returns an Accessible object for the . Invoked during the of the component. Invoked during the of the component. Gets/sets the object associated with the control. Note, the of this Appearance object does not affect the font used by the child controls of the . You should use the control's Font property instead.

The settings on this object affect the entire control. If you want to make only the area within the borders a certain color, set the property on the property.

Returns a Boolean value indicating whether an object has been created. Returns True if the Appearance object for the property has been created; otherwise, False.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Does nothing. Always returns null. Use the Image property off the or instead.

Do not use this property.

Gets/sets the type of border the content area displays.

This property allows you to specify the border displayed around the area of the control which contains the hosted controls. The default value of this property is 'Default' and is resolved based on the property setting.

Gets the resolved used by the control.

If the control's property is not set to 'Default' then that non-default value is returned. If it is set to 'Default', then the return value is based on the property.

Gets/sets the position of the control’s caption relative to the header edge closest to the first character of the caption.

This property controls where the caption appears in the header. The behavioral invariant of this property is that setting it to 'Near' will cause the caption to be rendered such that the first character is close to an edge of the header. In other words, setting this property to 'Far' will cause the last character of the caption to be rendered close to an edge of the header (possibly leaving a large gap between the first character and a header edge).

If the header is horizontal then setting this property to 'Near' means that the caption will be rendered on the left side of the header. If the header is vertical (i.e. on the left or right edge of the control) then the property must be taken into consideration to determine where the caption will appear. This is due to the fact that the property changes the direction that the caption is rendered.

Gets/sets the object associated with the content area. Note, the of this Appearance object does not affect the font used by the child controls of the . You should use the control's Font property instead. This object affects the area within the borders where other controls are hosted (i.e. the "content area"). If you want to set the background color for only the area within the borders then use this property. Returns a Boolean value indicating whether an object has been created. Returns True if the Appearance object for the property has been created; otherwise, False.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets the object used to determine the space between the border and the area containing the child controls.

Note, in the this property affects controls that are docked inside of the content area. In the this property affects all controls placed in the , regardless of their Dock state.

Gets the display rectangle for the control.

Returns the rectangle which defines the area within the content area's borders.

Not used for the .

Not used for the .

Not used for the .

Not used for the .

Gets/sets the object used by the header.

The settings on this object affect the control's header.

Returns a Boolean value indicating whether an object has been created. Returns True if the Appearance object for the property has been created; otherwise, False.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets/sets the type of border the header displays. Note, if the of the control is set to Office2003 or VisualStudio2005 this property is ignored.

This property can be used to adjust the border around the control's header. It can be set to any of the values available in the enum. Note, if the of the control is set to Office2003 or VisualStudio2005 this property is ignored. For those styles the header border style is always a solid line.

Gets the to be used for the header. If the control's property is not set to Default then that non-default value is returned. If it is set to Default, then the return value is based on the being used by the control.

If the of the control is set to Office2003 or VisualStudio2005 this property will always return 'Solid'. For all other view styles, 'None' is returned unless is set to a non-default value.

Gets/sets the value that determines which edge of the control the header will appear on and also whether the header appears inside, on, or outside the border.

This property can be used to determine the location of the controls header. There are two aspects involved with the different header positions: which side of the control, and the location relative to the controls border. The header can be on the top or bottom of the control (i.e. horizontal) or on the left or right side (i.e. vertical). The header can also be "on" the border, "outside" the border, or "inside" the border. The meaning of these latter terms are relative to the side of the control that the header is on.

For example, if the header is on the top edge of the control then "outside" the border means above it, and "inside" the border means below it. When the header is said to be "inside" the border, it always indicates that the header is contained within the content area of the control.

Gets the resolved location of the control's header.

If the control's property is not set to Default then that non-default value is returned. If it is set to Default, then the return value is based on the being used by the control.

Not used by the .

Not used by the .

Not used by the .

Not used by the .

Gets/sets the caption of the control.

This property can be used to specify the text which appears in the header of the control.

Gets the main UIElement for the control.

This property provides access to the main of the control. This element can be used as a starting point for traversal of the control's element hierarchy.

Gets/sets a bool indicating if the first character preceded by an ampersand will be treated as the control's mnemonic key.

Providing a mnemonic key for the control can make it easier for the end-user to quickly navigate an application's user interface. When the mnemonic key of an is pressed the first activate-able child control with the lowest TabIndex will be activated.

Not used by the .

Not used by the .

Gets/sets the direction that the caption faces when drawn vertically.

This property dictates whether the text in the header is drawn starting at the top or bottom. The must be set to a value which makes the header vertical for this property to have any effect. The value of this property affects the meaning of the property as well.

Gets/sets the visual scheme of the control.

The view style affects the colors and border style of the control.


Below is an overview of the different values:

  • XP - The control emulates the themed groupbox seen in Windows XP. The defaults to 'Rounded'.
  • Office2000 - The control emulates the groupbox seen in Micrsoft Office 2000 applications. The defaults to 'Rectangular3D'.
  • Office2003 - The control is rendered with colors which are in the style of Office 2003 applications. The defaults to 'RectangularSolid'.
  • Office2007 - The control is rendered with colors which are in the style of Office 2007 applications. The defaults to 'Rounded'.
  • VisualStudio2005 - The control is rendered with colors which are in the style of Visual Studio 2005. The defaults to 'RectangularSolid'.

Gets/sets whether the caption will be wrapped, if necessary.

Setting this property to true, in effect, enables the caption to be multi-line. Use the property to set the caption of the control.

Returns the resolved view style, taking into account any app-style settings. Returns the border style, taking into account the app-style setting and the app-style resolution order. This property can return Default. Overriden. This property is obsoleted. Please use object's BackColor property instead. For internal use only. Used for serializing out the BackColor property value. This is strictly for backward compatibility. Gets the main UIElement for the control Gets the default size that the control will use when created. This property is used internally by the control. Returns the event handler that notifies OnSubObjectPropChanged Used internally by the control. Returns true if the control has text display in the caption. Displays the About dialog for the control.

This property is only used at design-time.

Return the license we cached inside the constructor The Accessible object for an UltraGroupBox. Constructor. Returns the name of the accessible object. Gets the role of this accessible object. Creates a new instance of the UltraExpandableGroupBox control. Creates a new instance of the UltraExpandableGroupBox control. Returns true if a custom image has been assigned to the expansion indicator for when the control is collapsed. Resets the image shown in the expansion indicator when the control is collapsed.

Invoke this method to reset the property to its default value.

 Returns true if a custom image has been assigned to the expansion indicator for when the control is expanded. Resets the image shown in the expansion indicator when the control is expanded.

Invoke this method to reset the property to its default value.

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Returns a Boolean value that determines whether the property is set to its default value.

Returns True if the property is not set to its default value; otherwise, it returns False.

Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.

Invoke the method to reset this property to its default value.

 Resets the property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

 Returns the control collection of the UltraExpandableGroupBox. Disposes of system resources. Determines whether mouse messages should be routed to the control at design time. Overrides OnCreateControl. Invoked during the of the component. Fires the ExpandedStateChanged event. Fires the ExpandedStateChanging event. Allows you to prevent the control from expanding. Invoked when the control receives focus. Handles keystrokes. Invoked when the control loses focus. Overrides OnResize. Overrides ProcessMnemonic. Invalidates the Panel so that it repaints itself using the colors used by the . Factory method used to create the component role that provides the style information for the control. Called when a property or subobject's property value has changed. Returns an Accessible object for the . Fires after the control has expanded or collapsed. Handle the ExpandedStateChanged event to execute code immediately after the value of the property has changed. Handle the event to cancel a change to the control's expanded state. Fires before the control has expanded or collapsed. You can prevent the expanded state from changing by setting the Cancel property of the event argument to true. Handle the event to cancel a change to the control's expanded state. Handle the ExpandedStateChanged event to execute code immediately after the value of the property has changed. Returns the resolved border style for the content area.

This overrides the base class's implementation and resolves the border style differently if the control's property is false.

Do not use this property to add controls to the UltraExpandableGroupBox. Use the Panel property to access the UltraExpandableGroupBoxPanel. Use it's Controls collection instead. The panel stores the child controls for the group box. Instead of adding controls directly to the Controls collection of the they should be added to the Controls collection of the Panel property. The only ever has one child control; an . That panel hosts all of the controls contained within the group box. Gets and sets the expansion state of the .

When the value of this property is changed the will fire two events. First it will fire the event before the expanded state has been changed. A handler of that event can specify that the expansion state modification should be cancelled by setting the Cancel property on the to true. After the expanded state has changed the event will fire. A handler of that event can perform tasks that need to be performed after an expansion state modification, such as changing the header caption.

This property is used internally by the control and is not intended for use outside of the control.

This property is used internally by the control and is not intended for use outside of the control.

Gets and sets the location of the expansion indicator with respect to the upper left corner of the control and the . If you set this to GroupBoxExpansionIndicator.None the expansion indicator will not be displayed.

The control's header can be located on any of the four sides of the content area. If the header is on the top or bottom side (i.e. it is horizontal) then setting this property to 'Far' causes the expansion indicator to appear on the righthand side of the control. If the header is vertical then 'Far' means that the expansion indicator is to be positioned toward the bottom of the control.


If this property is set to 'None' then the expansion indicator will not be displayed. In that situation the property defaults to 'ToggleExpansion'. This enables the user to expand and collapse the control with the mouse, even though there is no expansion indicator.

Returns the resolved view style, taking into account any app-style settings. The image drawn on the expansion indicator when the control is collapsed. By default this is null (Nothing).

The specified image will be scaled to fit within a square roughly 16 by 16 pixels. The exact dimensions depend on the control's .

Returns true if a custom image has been assigned to the expansion indicator for when the control is collapsed. The image drawn on the expansion indicator when the control is expanded. By default this is null (Nothing).

The specified image will be scaled to fit within a square roughly 16 by 16 pixels. The exact dimensions depend on the control's .

Returns true if a custom image has been assigned to the expansion indicator for when the control is expanded. Gets/sets the action performed when the header is clicked. Note, this does not affect the behavior of the expansion indicator.

This property can be set to one of the three values. The default value of this property is 'Default', which means that the action taken in response to a header click is determined by the value of the property. If that property is set to 'None' then a click anywhere on the header will toggle the groupbox's expanded state. If an expansion indicator does exist then the default action is to do nothing (the expanded state is unaffected) in response to a click on the header. If this property is set to 'ToggleExpansion' then a click on either the header or expansion indicator will change the expanded state of the control.

Returns the resolved action performed when the header is clicked on.

If the property is set to a non-default value then that value will be returned. If it is set to 'Default' then this property will return 'ToggleExpansion' if the expansion indicator is not displayed, or 'None' if it is displayed. The expansion indicator can be removed by setting to 'None'.

Gets/sets the object used by the header when the is collapsed.

The settings made on this object affect the rendering of the control's header when the property is false.

Returns a Boolean value indicating whether an object has been created. Returns True if the Appearance object for the property has been created; otherwise, False.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets/sets the object used by the header when the is expanded.

The settings made on this object affect the rendering of the control's header when the property is true.

Returns a Boolean value indicating whether an object has been created. Returns True if the Appearance object for the property has been created; otherwise, False.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets/sets the object used by the header when the has hot tracking enabled and the cursor is over the header.

The settings made on this object affect the rendering of the control's header when the mouse cursor is over it and the property is set to true.

Returns a Boolean value indicating whether an object has been created. Returns True if the Appearance object for the property has been created; otherwise, False.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

 Gets the resolved header position.

Gets the resolved header position.

Gets/sets if the hot track appearance is used when the mouse is over the control. Specifies if the hot track appearance is used when the mouse is over the control. Gets a reference to used by the . If you are adding controls to the UltraExpandableGroupBox at runtime you need to add them to the Controls collection of this object, not to the Controls collection of the UltraExpandableGroupBox.

The can only have one child control; an . All other controls contained in the groupbox should be added to the Controls collection of the . Any attempt to add a control directly to the will result in an exception being thrown.

Gets/sets whether the expansion indicator shows the focus rectangle.

It is sometimes useful to allow the control to receive focus but to prevent it from rendering the focus rectangle (the dotted line within the borders of the expansion indicator). The ShowFocus property may be set to false to prevent the control from rendering the focus rectangle when the control receives focus. When set to true, its default value, the focus rectangle will be rendered when the control has the input focus.

Determines if the control can be given input focus via the Tab key.

Set this property to false if the user should not be able to navigate to the via the Tab key. The default value of this property is true.

Gets/sets the visual scheme of the control.

The view style primarily affects the colors and border style of the control. When the view style is set to 'Office2003' or 'VisualStudio2005' the expansion indicator will have a different size and appearance.


Below is an overview of the different values:

  • XP - The control emulates the themed groupbox seen in Windows XP. The defaults to 'Rounded'.
  • Office2000 - The control emulates the groupbox seen in Micrsoft Office 2000 applications. The defaults to 'Rectangular3D'.
  • Office2003 - The control is rendered with colors which are in the style of Office 2003 applications. The defaults to 'RectangularSolid'. The expansion indicator is circular with a chevron.
  • VisualStudio2005 - The control is rendered with colors which are in the style of Visual Studio 2005. The defaults to 'RectangularSolid'. The expansion indicator is a thin rectangle with a chevron.

Gets the default size that the control will use when created. This property is used internally by the control. Returns the default resolved value for UseHotTracking. Displays the About dialog for the control.

This property is only used at design-time.

Return the license we cached inside the constructor The Accessible object for an UltraExpandableGroupBox. Constructor. Performs the default action for the control in its current state. Returns the default action for the control in its current state. Designer for the . UltraGroupBoxDesigner interacts with the design-time environment for the . GetTextBaseLine Overrides UltraParentControlDesigner GetTextBaseLine DefaultableInteger GetTextFont Virtual method to resolve the font of the header text A copy of a font that the groupbox can use to calculate the snaplines. Note, this font must be disposed by the caller. Overrides OnPaintAdornments. Gets the default location for a control when it is added to the UltraGroupBox via double-clicking an icon in the Toolbox. Gets the for this designer's control/component. Provides DesignerActionItems for the SmartTag associated with the UltraGroupBox. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Indicates whether the specified control can be a child of the control managed by this designer. Attachs the designer to the design-time environment. Detachs the designer from the design-time environment. Overriden. Invoked when a toolbox item will be created and added to the associated control. Gets the default location for a control when it is added to the UltraExpandableGroupBox via double-clicking an icon in the Toolbox. Prevents the control from being resizable in certain directions when collapsed. Gets the for this designer's control/component. Provides DesignerActionItems for the SmartTag associated with the UltraExpandableGroupBox. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. UltraExpandableGroupBoxPanel hosts the controls contained in the . This class is intended only for use within the . If you need to add controls to an UltraExpandableGroupBox at runtime, you should add the controls to this object. The exposes a reference to its UltraExpandableGroupBoxPanel via the property. Initializes a new instance. Overrides OnPaint. Overrides OnPaintBackground. Forces the ExpandableGroupBoxPanel to honor the new DisplayRectangle. Designer for the . Indicates whether the control represented by the designer can be parented to the specified designer. Parent designer to evaluate Return true for a designer representing a tab control. Specifies how the should be selectable at design time. Overrides AddDefaultVerbs. UltraGroupBoxUIElement represents the visual aspects of the control. Initializes a new . The UltraGroupBox associated with this element.

Initializes a new .

Initializes the appearance of the UltraGroupBoxUIElement. Handles the creation and positioning of the child elements Returns the preferred width of the Vertical header. This method returns the width that the horizontal header needs to be in order to display the entire text with no clipping. Returns the preferred width of the Horizontal header. This method returns the width that the horizontal header needs to be in order to display the entire text with no clipping. Returns the owning control.

The passed into this element's constructor is returned.

Returns the associated with this element. Represents a standard windows label.

The UltraLabel control has functionality similar to that of the intrinsic .Net Label control as well as some additional functionality. There is an property that can be used to specify a gradient or hatched appearance as well as a to more easily provide a different appearance when the mouse is over the control.

The and can be used to create various border effects. The controls the amount of space between the inner and outer borders.

 Initializes a new UltraLabel Invoked when a mnemonic has been pressed. Character to process True if the character was processed as a mnemonic of the control. Resets the property to its default value.

Resets the property to its default value.

Indicates if the property should be serialized. True if the property value differs from the default value Invoked when the preferred size for the control should be calculated Returns the width available for displaying the image and text contents. Resolves any remaining appearance settings for the control that have not been specified by the appearance properties. Appearance structure to update Appearance properties to resolve Factory method used to create the component role that provides the style information for the control. Creates a new accessibility object for the control. A new for the control. Returns the main UIElement for the control Gets/sets the style of border displayed for the inner border.

This property can be used to adjust the style of the border which appears closer to the control's text, as opposed to the border specified via .

Returns the resolved border style for the inner border.

If the property is set to a non-default value then that value will be returned. Otherwise, the standard border style value is returned.

Gets/sets the style of border displayed for the outer border

This property can be used to adjust the style of the border which appears closer to the control's edge, as opposed to the border specified via .

Returns the resolved border style for the outer border

If the property is set to a non-default value then that value will be returned. Otherwise, the standard border style value is returned.

Gets/sets the amount of space between the inner and outer borders.

This property can be used in scenarios where the desired visual effect requires a gap between the inner and outer borders of the control. The style of those borders can be specified via the and properties, respectively.

Determines whether the control will receive focus when tabbing through the controls.

This property should not be used for the .

Overriden. Determines the default ImeMode for the control.

Since the UltraLabel control does not receive focus and does not use the key messages, the default ImeMode is disabled.

 Determines the ImeMode for the control. Determines the ImeMode for the control. Returns the default size for the control. Displays the About dialog for the control.

This property is only used at design-time.

Return the license we cached inside the constructor The Accessible object for an UltraLabel. Constructor Retrieves the object that has the keyboard focus. An AccessibleObject that specifies the currently focused child. This method returns the calling object if the object itself is focused. Returns a null reference (Nothing in Visual Basic) if no object has focus. Retrieves the currently selected child. An AccessibleObject that represents the currently selected child. This method returns the calling object if the object itself is selected. Returns a null reference (Nothing in Visual Basic) if is no child is currently selected and the object itself does not have focus. Retrieves the child object at the specified screen coordinates. The horizontal screen coordinate. The vertical screen coordinate. An AccessibleObject that represents the child object at the given screen coordinates. This method returns the calling object if the object itself is at the location specified. Returns a null reference (Nothing in Visual Basic) if no object is at the tested location. Navigates to another accessible object. One of the values. Gets the role of this accessible object. Gets the state of this accessible object. Returns the associated UltraLabel control. Designer used by the control. Gets the for this designer's control/component. Provides DesignerActionItems for the SmartTag associated with the UltraLabel. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Gets or sets the Text property on this designer's control Main element for the control Initializes a new UltraLabelControlUIElement UltraLabel control owning the uielement Handles the creation and positioning of the child elements Initializes the appearance information for the uielement Appearance structure to update Appearance properties to resolve Invoked when the borders for the control are to be rendered. Draw parameters Returns the owning label control Returns the contained UIElement that renders the image and text. Returns the rectangle representing the area within the borders of the element Rectangle representing the area within the borders of the element Returns the outer border style for the element. Returns the associated with this element. An used to represent a control in a

The ControlLayoutItem class is used by the class to manage the constraints for the controls in its associated .

 Initializes a new

The ControlLayoutItem is used to manage layout constraints and may be used with any .

 The control whose constraints are being stored in this Indicates whether the property is set to its default value.

This method returns a boolean indicating if the property has been changed from its default value.

 A boolean indicating whether the property has been set. Resets the property.

This method resets the property to its default value.

 Indicates whether the property is set to its default value.

This method returns a boolean indicating if the property has been changed from its default value.

 A boolean indicating whether the property has been set. Resets the property.

This method resets the property to its default value.

 Returns the associated Control.

This is a read-only property that returns the whose constaints are managed by this object.

 Returns or sets the minimum size of the

The MinimumSize is used by a derived layout manager when determining how the layout should be arranged and indicates the minimum size that the control can allow. If the property has not been set, the value returned will be 0, 0 or if the control implements , it will be the return value from the control's .

Note: Not all layout managers change the size of the controls whose layout it manages and therefore this property may not affect the layout.

 Returns or sets the preferred size of the .

The PreferredSize is used by a derived layout manager when determining how the layout should be arranged and indicates the preferred size to which the control would like to be sized. If the property has not been set, the value returned will be the current size of the or if the control implements , it will be the return value from the control's .

Note: Not all layout managers change the size of the controls whose layout it manages and therefore this property may not affect the layout.

 Returns or sets whether the item should participate in the layout.

The IncludeInLayout is used to determine whether the should arrange the associated when it arranges the controls it manages.

 Returns or sets the constraint associated with the control.

Note: Not all layout managers use additional constraints but those that do require that the constraints be of a certain type. For example, the requires additional constraints and it must be an object that implements .

 Returns the minimum size for the layout item Returns the preferred size for the layout item Indicates whether the item is visible or not. Items that are not visible are ignored. Base class for a component that manages the size and position of controls within their parent control.

The component is an abstract base class for a component that utilizes a derived layout manager for controlling the position and size of controls within a specific . The property must be set so the component knows which controls to arrange.

At design time, the component adds 3 extender properties to each control within the associated ContainerControl. IncludeInLayout is used to indicate whether the control should be arranged by the component. By default, all controls within the ContainerControl are arranged by the component. MinimumSize is used to indicate to the associated layout manager what is the minimum size that the control should be displayed at. PreferredSize is used to indicate the size at which the control would prefer to be set. Since these are extender properties, if you need to access the values at runtime, you must use the corresponding get/set methods on this component (e.g. to access the IncludeInLayout property, you would use the and methods).

The component includes a set of methods that may be used to control when the arrangement of the controls will occur. is used to prevent the component from arranging the controls. This can be useful when programatically adding controls or initializing the layout properties of many controls within the . In order to have the component resume processing layout requests, you must invoke the method. The method can be used to explicitly force a layout to occur.

 Initializes a new . An IContainer representing the container of the ControlLayoutManagerBase Initializes a new . Indicates if any of the properties of the have been changed.

This method returns a boolean indicating if any of the propertyies of the object have been set.

 Returns true if any properties of the have been changed. Resets the properties of the to their default values.

This method resets the properties of the object to their default values.

 Invoked when the component must release the resources it is using. True if managed resources should be released. Invoked during the of the component. Invoked during the of the component. Used to create a for a control Control for which the should be created A new that represents the specified control Derived class should create a layout manager and return it. It will be cached so the implementing class need not cache the created layout. Invoked when a cached is removed. Layout item being removed Invoked when the Constraint of a should be initialized. Layout item for which the constraint is being created. Returns a constraint object or null if the underlying layout manager doesn't use a constraints. Notifies the container control that the layout should be updated. Invoked when a property on a sub object has changed. Gets the LayoutItem object associated with the passed in control. Control whose layout item should be returned True to create and cache a new control layout item if one does not yet exist. The associated with the specified control Invoked when the property has been changed Previous container control New container control Event handler for handling layout event of the associated container control. Gets the minimum size of the control. Control managed by the component.

The MinimumSize is used when determining how the layout should be arranged and indicates the minimum size that the control can allow. If the property has not been set, the value returned will be 0, 0 or if the control implements , it will be the return value from the control's .

Note: Not all layout managers change the size of the controls whose layout it manages and therefore this property may not affect the layout.

 The minimum size for the control. Sets the minimum size for the control. Control managed by the component

The MinimumSize is used when determining how the layout should be arranged and indicates the minimum size that the control can allow.

Note: Not all layout managers change the size of the controls whose layout it manages and therefore this property may not affect the layout.

 Minimum size for the control Indicates whether the control should serialize the minimum size for the passed in control.

This method returns a boolean indicating whether the MinimumSize has been specified for the .

 Control managed by the component A boolean indicating if the minimum size for the specified control should be serialized Resets the minimum size of the passed in control. Control managed by the component

This method resets the MinimumSize for the to its default value - 0,0.

 Gets the preferred size of the control. Control managed by the component

The PreferredSize is used when determining how the layout should be arranged and indicates the preferred size to which the control would like to be sized. If the property has not been set, the value returned will be the current size of the or if the control implements , it will be the return value from the control's .

Note: Not all layout managers change the size of the controls whose layout it manages and therefore this property may not affect the layout.

 The preferred size for the specified control Sets the preferred size for the control. Control managed by the component New preferred size for the specified control

The PreferredSize is used when determining how the layout should be arranged and indicates the preferred size to which the control would like to be sized. If the property has not been set, the value returned will be the current size of the or if the control implements , it will be the return value from the control's .

Note: Not all layout managers change the size of the controls whose layout it manages and therefore this property may not affect the layout.

 Indicates whether the control should serialize the preferred size for the passed in control. Control managed by the component

This method returns a boolean indicating whether the PreferredSize has been specified for the .

 A boolean indicating whether the preferred size for the specified control should be serialized. Resets the preferred size of the passed in control.

This method resets the value of the PreferredSize for the specified control to its default value, which is its current size or the size indicated by its if the control implements the interface.

 Control managed by the component Gets a value indicating whether the control's position should be adjusted by the layout manager. Control managed by the component

The IncludeInLayout is used to determine whether the component should arrange the specified when it arranges the controls in the . By default, all controls in the are arranged by the component. You can use the method to prevent the control from being arranged by the component.

 True if the control's position is managed by the component; otherwise false is returned Determines whether the control's position should be adjusted by the layout manager. Control managed by the component True if the control's position should be managed by the component; otherwise false.

The IncludeInLayout is used to determine whether the component should arrange the specified when it arranges the controls in the .

 Indicates whether the control should serialize the preferred size for the passed in control. Control managed by the component

This method returns a boolean indicating whether the IncludeInLayout has been specified for the .

 A value indicating whether the IncludeInLayout setting for the control should be serialized Resets the value which controls whether the component should manage the position and size of the control. Control managed by the component

This method resets the value of the PreferredSize for the specified control to its default value, which is the value indicated by its if the control implements the interface otherwise its true.

 Suspends processing the positioning of the controls managed by the component.

The SuspendLayout method is used to prevent the component from arranging the controls in its associated . This method is often used when programatically adding controls to the control container or when initializing the constraints for the controls it arranges.

must be called for each time that SuspendLayout is invoked.

 Resumes processing the positioning of the controls managed by the component.

The ResumeLayout method is used after invoking the method so that the component knows that it may begin arranging the controls in its associated . This method invokeds the overload passing in true so that it will arrange the controls if any layout events were invoked since was invoked.

ResumeLayout must be called for each time that is invoked.

 Resumes processing the positioning of the controls managed by the component. True if the layout has been dirtied since the layout was suspended and the layout should be updated now. If false is returned and a pending layout was required, no layout will be performed.

The ResumeLayout method is used after invoking the method so that the component knows that it may begin arranging the controls in its associated .

ResumeLayout must be called for each time that is invoked.

 Processes any pending positioning of the controls managed by the component.

The PerformLayout method is used to force the component to synchronously arrange the controls within its associated . This overload will invoke the overload passing in false, which indicates that the underlying should not dirty any cached layout information it contains.

 Notifies the container control that the layout should be updated. True to clear any cached layout information before performing the layout

The PerformLayout method is used to force the component to synchronously arrange the controls within its associated .

Implementation of IExtenderProvider.CanExtend method. Positions the passed in item setting the item's bounds to the passed in rect. Returns the bounds of the container. Container control whose child controls are arranged by the layout manager.

The ContainerControl is used to determine whose controls will be arranged by the component. The layout manager will arrange all the controls within the specified control unless the has been invoked with a value of false to indicate that a particular control should not be affected by the layout manager.

At designtime, all controls within the specific container control will have 3 additional properties - IncludeInLayout, MinimumSize, and PreferredSize. At runtime, you can access the values of these using the corresponding get/set methods (e.g. to access the IncludeInLayout value, you can use the and .

Note: This property must be set in order for the component to know which controls to arrange. In addition, the component only manages the direct children of the container control. It does not arrange any controls within those controls.

 Returns the margins object used to modify the bounds used to position the controls in the

The Margins property returns an instance of a that can be used to adjust the area of the associated in which the controls will be arranged. By default, the component uses the as the area within the container control that the controls will be arranged. The property values of the Margins will be used to adjust this rectangle. By default, the Left, Top, Bottom and Right as set to 0 so no adjustment of the display rectangle is made.

 Indicates if the object has been allocated.

This is a read-only property that returns a boolean indicating if the object has been created.

 Indicates if the layout is currently suspended

This property returns a boolean indicating if the component will ignore layout requests.

 Returns the preferred size required to layout the items in the

This property defers to the method of the associated and returns a value based on the constraints that indicates the size that is required to layout the items based on their preferred size information.

 Returns the minimum size required to layout the items in the

This property defers to the method of the associated and returns a value based on the constraints that indicates the minimum size that is required to layout the items based on their minimum size of the controls with the .

 Returns the layout manager.

This is a read-only property that returns the that the component uses to arrange the controls in the .

 Returns the event handler that for the method that is used to receive notifications when a property on a sub-object has changed. Designer class for an Invoked when the designer is associated with a component. Associated component Invoked when a new component is created. Dictionary Invoked when the designer is disposed. Invoked when an existing component is being initialized. Dictionary Gets the for this designer's control/component. Provides DesignerActionItems for the SmartTag associated with the UltraFlowLayoutManager. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Provides DesignerActionItems for the SmartTag associated with the UltraGridBagLayoutManager. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. TypeConverter for the of an Initializes a new Returns a list of the controls that can be selected as the Returns true if the value is allowed UITypeEditor for choosing the of an Used to determine the type of UIEditor that will be displayed. ITypeDescriptorContext UITypeEditorEditStyle specifying the type of UIEditor. Used to edit the value and convert the value as needed. ITypeDescriptorContext IServiceProvider Current value Edited value. Dialog for selecting the of an Required designer variable. Clean up any resources being used. Required method for Designer support - do not modify the contents of this method with the code editor. Returns the currently selected control. Component that uses a flow layout manager to arrange controls in its associated

The UltraFlowLayoutManager is component that is designed to arrange controls in such a way that they flow within the associated . The controls may be arranged either horizontally or vertically depending upon the and the controls can either be arranged in a single column/row or multiple depending on the property.

The component exposes three additional properties that control the layout of the controls. The and are used to control the amount of space between items and rows/columns of items. The is used to determine how the items are aligned with respect to their orientation.

 Initializes a new

Initializes a new

Initializes a new An IContainer representing the container of the UltraFlowLayoutManager

Initializes a new

Invoked to create the layout manager used by the component to arrange the controls in the associated A new Invoked when a constraint for the specified layout item should be created Control for which the constraint is being created. Returns null (or nothing in VB) since the does not use any special constraints Returns or sets whether the flow layout flows items in vertical direction or horizontal direction.

The Orientation property determines how the items are arranged within the associated . When set to Vertical, the items are arranged from top to bottom. If is set to true and an item does not fit within the container control, the item will be positioned into a new column to the right of the first. When set to Horizontal, the controls are arranged from left to right. If is set to true and an item does not fit within the container control, the item will be positioned into a new row below the previous row of controls.

 Returns or sets the horizontal gap in pixels between each item as well as the border of the container and items.

The HorizontalGap is the number of pixels of space added to the left and right of each control. The can be used to adjust the number of pixels above and below each control.

 Returns or sets the vertical gap in pixels between each item as well as the border of the container and items.

The is the number of pixels of space added to the left and right of each control. The VerticalGap can be used to adjust the number of pixels above and below each control.

 Returns or sets the alignment of the controls with respect to the orientation.

The Alignment property indicates how the row or column of cotrols is arranged based on the . If the Orientation is set to Horizontal, the alignment will affect the horizontal alignment of the controls. If the Orientation is set to Vertical, the alignment will affect the vertical alignment of the controls.

 Returns or sets whether items should wrap around to a new line when there is not enough room to display all the items on a single line.

The WrapItems property determines whether the controls are arranged in a single row/column (depending on the ) or whether they are arranged into multiple rows/columns. When the is set to Vertical,

Displays the About dialog for the control. Return the license we cached inside the constructor Component used to manage the position and size of controls using a GridBagLayout style management.

The UltraGridBagLayoutManager is a component that is used to arrange controls based on a set of constraints for each control. An additional property is added to each control within the associated - GridBagConstraint. To programatically change this property, you can use the associated get/set methods (i.e. and ).

The exposes properties that are used to determine how/where the control should be positioned and includes properties such as , , and . The OriginX and OriginY are used to determine the location at which the control will be positioned. The SpanX and SpanY determine the number of logical columns and rows that the control will occupy. Together these indicate the logical cells that the control will occupy.

The GridBagConstaint available for each control also provides additional properties to control the size of the logical cells that the control will occupy. For example, the and are used to determine how the excess horizontal and vertical space respectively is distributed amongst the controls. The property is used to indicate how much padding should exist around the control.

The GridBagConstaint also includes two properties that control how the control is positioned within the logical cells it occupies. The property is used to indicate which edge of the logical cells that the control should align with. The property determines which dimensions, if any, should be resized based on the corresponding width/height of the logical cells.

 Initializes a new Initializes a new An IContainer representing the container of the UltraGridBagLayoutManager Gets the which contains the constraints for the specified control. Control managed by the component.

The exposes properties that are used to determine how/where the control should be positioned and includes properties such as , , and . The OriginX and OriginY are used to determine the location at which the control will be positioned. The SpanX and SpanY determine the number of logical columns and rows that the control will occupy. Together these indicate the logical cells that the control will occupy.

The GridBagConstaint available for each control also provides additional properties to control the size of the logical cells that the control will occupy. For example, the and are used to determine how the excess horizontal and vertical space respectively is distributed amongst the controls. The property is used to indicate how much padding should exist around the control.

The GridBagConstaint also includes two properties that control how the control is positioned within the logical cells it occupies. The property is used to indicate which edge of the logical cells that the control should align with. The property determines which dimensions, if any, should be resized based on the corresponding width/height of the logical cells.

 The grid bag constraint for the specified control Sets the for the specified control. Control managed by the component. GridBagConstraints for the specified control

The exposes properties that are used to determine how/where the control should be positioned and includes properties such as , , and . The OriginX and OriginY are used to determine the location at which the control will be positioned. The SpanX and SpanY determine the number of logical columns and rows that the control will occupy. Together these indicate the logical cells that the control will occupy.

The GridBagConstaint available for each control also provides additional properties to control the size of the logical cells that the control will occupy. For example, the and are used to determine how the excess horizontal and vertical space respectively is distributed amongst the controls. The property is used to indicate how much padding should exist around the control.

The GridBagConstaint also includes two properties that control how the control is positioned within the logical cells it occupies. The property is used to indicate which edge of the logical cells that the control should align with. The property determines which dimensions, if any, should be resized based on the corresponding width/height of the logical cells.

 Indicates whether the control should serialize the grid bag constraint for the passed in control. Control managed by the component

This method returns a boolean indicating whether the GridBagConstraint has been specified for the .

 True if any property on the grid bag constraint has been changed Resets the grid bag constraint of the passed in control. Control managed by the component

This method resets the for the specified control to their default values.

 Invoked to create the layout manager used by the component to arrange the controls in the associated A new Invoked when a constraint for the specified layout item should be created Control for which the constraint is being created. Invoked when a property on a sub object has changed. Invoked when a cached is removed. Layout item being removed Returns or sets whether to proportionally resize widths of all the items to fit any extra width.

Note: This would only get applied if all the items had 0.0 weightX's.

 Returns or sets whether to proportionally resize heights of all the items to fit any extra height.

Note: This would only get applied if all the items had 0.0 weightY's.

 Displays the About dialog for the control. Return the license we cached inside the constructor Component for displaying a control in a popup window.

The UltraPopupControlContainer is a component that can be used to display any derived class in a separate popup window. The property is used to indicate which control should be displayed in the popup window.

The method can be used to display the popup window. There are several overloads of the method so that the position of the popup can be controlled. The method may be used to hide the popup window.

The member is a static method that may be used to obtain a reference to the UltraPopupControlContainer that is currently displaying the specified control.

The class exposes several events to provide a notification when the popup window is opening ( and ) and closed ().

 Initializes a new .

Initializes a new .

Initializes a new using the specified container. The object which implements IContainer to be used by the control.

Initializes a new using the specified container.

Used to display the popup window.

Displays the popup window using the current position of the mouse cursor as the preferred location.

Used to display the popup window at the specified location. Location of the popup window in screen coordinates

Displays the popup window using the specified Point as the preferred location.

Used to display the popup window with the specified owner control. Owning control

Displays the popup window using the current position of the mouse cursor as the preferred location. The 'owner' argument is used to indicate which control is the owning control during the popup operation.

Used to display the popup window at the specified location with the specified owner control. Owning control Location of the popup window in screen coordinates

Displays the popup window using the specified Point as the preferred location. The 'owner' argument is used to indicate which control is the owning control during the popup operation.

Returns a dropped down that contains the specified control.

The FromControl method will return the instance that is currently displaying the specified control or an ancestor of the specified control.

Note The popup window must be displayed or the associated UltraPopupControlContainer will not be available from this method.

 Control to evaluate. May be the control dropped down from the button or a child of that control. The UltraPopupControlContainer displaying the specified control in a dropdown window or null if the control is not contained in a dropdown from an UltraPopupControlContainer Used to invoke the event before the dropdown is displayed. Event arguments Used to invoke the event before the dropdown is displayed. Event arguments Used to invoke the event when the dropdown has been closed. Event arguments Used to close up the popup window.

If the popup window is displayed (see ), the popup window may be closed using the Close method. When the popup window is closed, the event will be raised.

 Used to display the popup window with the specified position information.

The Show method is used to display the popup window. The is used to provide position and owner information for the popup window.

 Provides information about the location of the popup Returns or sets the control that will be displayed in the popup.

The PopupControl is the control that will be displayed in the popup window when the method is invoked.

Note Attempting to set the property while the popup window is displayed (see ) will result in an exception.

 Invoked before the dropdown is displayed

The Opening event is raised when the method is invoked but before the dropdown window is displayed. This event can be used to initialize the or adjust the size of the control, since the size of the control will control the size of the popup window.

The event may be cancelled by setting the property to true. If the event is not cancelled and the PopupControl is specified, the popup window will be displayed and the event will be invoked.

 Invoked after the dropdown is displayed

The Opening event is raised when the method is invoked but before the dropdown window is displayed. This event can be used to initialize the or adjust the size of the control, since the size of the control will control the size of the popup window.

The event may be cancelled by setting the property to true. If the event is not cancelled and the PopupControl is specified, the popup window will be displayed and the event will be invoked.

 Displays the About dialog for the control.

This property is only used at design-time.

Return the license we cached inside the constructor Invoked when the popup window has been closed.

The Closed event is raised when the popup window has been closed, whether it is the result of clicking elsewhere on the screen or when closed via the method.

 Indicates if the popup window is currently being displayed.

The IsDisplayed property will return true while the popup window is displayed.

 Returns the Control that displayed the popup window.

Returns the Control that displayed the popup window. This property is only available at runtime.

Designer for the Prepares the designer to view, edit, and design the specified component. Component to be managed by the designer Disposes of resources used by the designer True if managed resources should be released. Gets the for this designer's control/component. Provides DesignerActionItems for the SmartTag associated with the UltraPopupControlContainer. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. UIElement contained within a that contains all the instances that represent each page in the preview window. Initializes a new Parent element Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Creates and positions the contained elements. Invoked when the middle mouse button is held down and the mouse is dragged horizontally. The number of pixels between the cursor position and the origin mark. This value is positive when the cursor is to the right of the origin mark, negative when it is left of the origin mark, and zero if it is within the origin mark threshold Invoked when the middle mouse button is held down and the mouse is dragged vertically. The number of pixels between the cursor position and the origin mark. This value is positive when the cursor is below the origin mark, negative when it is above the origin mark, and zero if it is within the origin mark threshold Overrides the default mouse down behavior to capture the mouse on a left mouse button down. Mouse event arguments True if left clicked over adjustable area of element. If not null on return will capture the mouse and forward all mouse messages to this element. If true then bypass default processing Called on a mouse move message Mouse event arguments Clear internal flags and invalidate the button Returning true will ignore the next click event Called when mouse capture has been aborted, for example, when the 'escape' key is pressed during a drag operation. Invoked after the element and its children have been rendered. Structure containing information for the draw operation. Invoked when element is being disposed. Returns true to clip the page elements to the area within the borders of the page area element. Determines whether horizontal panning is allowed. Determines whether vertical panning is allowed. Indicates if capture for this element should be terminated if the escape key is pressed. Returns the associated with this element. UIElement that represents a single page. Initializes a new Parent element The page to be displayed by the element. Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Creates and positions the contained elements. Returns the associated preview page. UIElement representing a page number for a preview page. Initializes a new Parent element Page number represented by the element Initializes a new Parent element Page number represented by the element Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Clear internal flags and invalidate the button Returning true will ignore the next click event Returns the associated page number. Indicates if the element should render its backcolor. Returns the border style for the page number. Returns the associated with this element. UIElement used to represent a ruler for an . Initializes a new Parent element Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Overriden. Renders the numbers and ruler lines. Draw parameters Returns true so that the overridden Region property will be used while rendering. Returns the region of this element. The deafult returns the element's Rect as a region. This method can be overriden to supply an irregularly shaped region Returns the associated with this element. UIElement that provides the shadow for a Initializes a new Parent element Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Returns the associated with this element. The uielement that represents a single page in the . Initializes a new Parent element The page to be displayed by the element. Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Invoked when the background image for the element should be rendered. Draw params structure containing information about the draw operation Creates and positions the contained elements. Overrides the default mouse down behavior to capture the mouse on a left mouse button down. Mouse event arguments True if left clicked over adjustable area of element. If not null on return will capture the mouse and forward all mouse messages to this element. If true then bypass default processing Clear internal flags and invalidate the button Returning true will ignore the next click event Returns an object of requested type that relates to the element or null. The requested type or null to pick up default context object. If true will walk up the parent chain looking for the context. Classes that override this method normally need to override the method as well. Returns the associated preview page. The border for the element. Returning true causes all drawing of this element's child elements to be expicitly clipped to the area inside this elements borders Returns the rect inside borders as the default Indicates if the element supports accessibility Returns the accessible object representing this node. Returns the associated with this element. UIElement used to render the zoom rectangle within a page of an Initializes a new Containing page element Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Default border rendering Structure containing information for the draw operation. Called when the mouse down message is received over the element. Mouse event arguments True if left clicked over adjustable area of element. If not null on return will capture the mouse and forward all mouse messages to this element. If true then bypass default processing Called when the mouse is moved over the element or during capture Called when the mouse is released Returning true will ignore the next click event Called when mouse capture has been aborted, for example, when the 'escape' key is pressed during a drag operation. Called when the mouse down message is received over the element. Mouse event arguments True if left clicked over adjustable area of element. If not null on return will capture the mouse and forward all mouse messages to this element. If true then bypass default processing The border for the element. Returns the rectangle after adjusting for any borders True if this element supports left to right adjustments by grabbing the left border True if this element supports up and down adjustments by grabbing the top border. True if Adjustment Bar should be drawn while sizing. Returns true if this element can be moved or resized by the mouse Indicates if capture for this element should be terminated if the escape key is pressed. Returns the associated with this element. UIElement representing the area where a vertical and horizontal intersect. Initializes a new Parent element Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Returns the associated with this element. UIElement representing the area displaying a ruler for the preview pages. Initializes a new Parent element True for a vertical ruler area Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Creates and positions the contained elements. Returns the associated with this element. Control element for a Initializes a new Associated UltraPrintPreviewControlBase Creates and positions the contained elements. Invoked when a mouse down message is received. Returning true will cause normal mouse down processing to be skipped Initialize the appearance structure for this element The apperance structure to initialize The properties that are needed Performs the specified action. Action to perform True if the shift key is pressed True if the control key is pressed True if the action was performed; otherwise false is returned. Returns or sets the border style used by the control. Returns the current state of the control Returns the key action mappings from the associated control Returns the associated with this element. Enumerates the possible actions that can be performed on the UltraExplorerBar Scrolls down as the control would when clicking in the bottom scroll track. Scrolls up as the control would when clicking in the top scroll track. Scrolls to the top of the preview pages Scrolls to the bottom of the preview pages Scrolls down as the control would when clicking on the down scroll arrow Scrolls up as the control would when clicking on the up scroll arrow Scrolls left as the control would when clicking in the left scroll track. Scrolls right as the control would when clicking in the right scroll track. Scrolls to the left edge of the preview pages Scrolls to the right edge of the preview pages Scrolls left as the control would when clicking on the left scroll arrow Scrolls right as the control would when clicking on the right scroll arrow Scrolls the control so that the first page is in view. Scrolls the control so that the last page is in view. Scrolls the control so that the previous page that is not fully in view is brought into view. Scrolls the control so that the either next page in the preview row that is not fully in view is brought into view or the first page in the next preview row is brought into view. Changes the zoom to a lower value. Changes the zoom to a higher value. Enumerates the possible actions that can be performed on the UltraExplorerBar Scrolls down as the control would when clicking in the bottom scroll track. Scrolls up as the control would when clicking in the top scroll track. Scrolls to the top of the preview pages Scrolls to the bottom of the preview pages Scrolls down as the control would when clicking on the down scroll arrow Scrolls up as the control would when clicking on the up scroll arrow Scrolls left as the control would when clicking in the left scroll track. Scrolls right as the control would when clicking in the right scroll track. Scrolls to the left edge of the preview pages Scrolls to the right edge of the preview pages Scrolls left as the control would when clicking on the left scroll arrow Scrolls right as the control would when clicking on the right scroll arrow Changes the zoom to a lower value. Changes the zoom to a higher value. Changes the view (, and scroll positions) to the previous value in the view history. Changes the view (, and scroll positions) to the next value in the view history. Resets/clears the view history. Scrolls the control so that the first page is in view. Scrolls the control so that the last page is in view. Scrolls the control so that the previous page that is not fully in view is brought into view. Scrolls the control so that the either next page in the preview row that is not fully in view is brought into view or the first page in the next preview row is brought into view. Bit flags that describe the state of the . The preview control has pages. There are 1 or more pages prior to the that may be scrolled to. There are 1 or mores pages after the that may be scrolled to. Bit flags that describe the state of the . The preview control has pages. The current is Hand The current is None The current is Snapshot The current is DynamicZoom The current is ZoomIn The current is ZoomOut There is a previous entry in the view history (). There is a previous entry in the view history (). There are 1 or more pages prior to the that may be scrolled to. There are 1 or mores pages after the that may be scrolled to. Key/Action mapping object for control. Initializes a new Indicates which key the action will be associated with Action to perform State that the control cannot be in State that the control must be in Modifier keys that cannot be pressed Modifier keys that must be pressed Gets/sets the action code. Gets/sets the disallowed state. These are bit flags that specify the state that the control MUST NOT be in for this mapping to be active. If the current state of the control has any of these bits turned on this mapping will be ignored. Gets/sets the required state. These are bit flags that specify the state that the control MUST be in for this mapping to be active. Key/Action mapping object for control. Initializes a new Indicates which key the action will be associated with Action to perform State that the control cannot be in State that the control must be in Modifier keys that cannot be pressed Modifier keys that must be pressed Gets/sets the action code. Gets/sets the disallowed state. These are bit flags that specify the state that the control MUST NOT be in for this mapping to be active. If the current state of the control has any of these bits turned on this mapping will be ignored. Gets/sets the required state. These are bit flags that specify the state that the control MUST be in for this mapping to be active. PreviewThumbnailKeyActionMappings.

This class maps keyboard keys with UltraPrintPreviewThumbnail actions.

 Initializes a new Called the first time GetActionMapping is called (enables lazy loading of mappings) IEnumerable Interface Implementation returns a type safe enumerator Returns whether or not the specified action is allowed based on CurrentState. Action to evaluate Current state of the control True if the action is allowed Copies the elements of the collection into the array. The array to copy to The index to begin copying to. Creates an instance of an ActionStateMappingsCollection derived class Returns or sets the item at the specified index. PreviewThumbnailKeyActionMappingEnumerator Constructor Mappings class to enumerate non-IEnumerator version: type-safe PreviewControlKeyActionMappings.

This class maps keyboard keys with UltraPrintPreviewControl actions.

 Initializes a new Called the first time GetActionMapping is called (enables lazy loading of mappings) IEnumerable Interface Implementation returns a type safe enumerator Returns whether or not the specified action is allowed based on CurrentState. Action to evaluate Current state of the control True if the action is allowed Copies the elements of the collection into the array. The array to copy to The index to begin copying to. Creates an instance of an ActionStateMappingsCollection derived class Returns or sets the item at the specified index. PreviewControlKeyActionMappingEnumerator Constructor Mappings class to enumerate non-IEnumerator version: type-safe Object used to maintain information about each print preview page. Invoked when the object is disposed. Gets the image of the printed page. Gets the size of the printed page, in hundredths of an inch. Gets the margins of the printed page, in hundredths of an inch. Gets the size of the printed page, in hundredths of an inch. A collection of instances Creates an array of based on the current Invoked when the object is disposed. Returns a type specific enumerator for the collection. Returns the at the specified page. Returns the items in the collection as an array. Returns the initial capacity for the collection. Indicates if the collection is read-only. Class for enumerating a instance. Initializes a new Returns the current in the enumeration Returns or sets the maximum number of preview pages that should be generated. Gets a value indicating if this is used for print preview. True always Gets a value indicating if this is used for print preview. True if the is used for print preview, otherwise, false. Required designer variable. Clean up any resources being used. Required method for Designer support - do not modify the contents of this method with the code editor. Class for managing the pages in view. Invoked when the client area of the control has changed. Invoked when the preview pages have changed or been reset. Invoked when a property on the control has changed. Object indicating what property changed Returns the first page number in the specified row Returns the last page number in the specified row Returns the width and height of the specified row. Calculates the scroll range for the page. The calculation returns values that when used will allow the page to be scrolled so that only 1 pixel is kept in view. Page to evaluate A scroll range indicating the scroll range for the page This is a test function for drawing and verifying the calculated page rects against those positioned. Returns the rectangle representing the location of the specified page within its containing fixed row. Page number to evaluate Returns an array of PageRect instances that represents the PreviewRows that are in view. An array of instances representing the pages from the preview rows in view. Returns the fixed rows calculated for the current layout. Returns the preview rows calculated for the current layout. Returns the index of the fixed row currently in view. The first preview row in view. The last preview row that can be in view. Returns the vertical offset into the first visible preview row. Returns the horizontal offset of the preview rows. Returns the size required for the page number Returns the pixel size of the visible row area. Returns the zoom for the visible rows Indicates if a vertical scrollbar would be required. Indicates if a horizontal scrollbar would be required. Returns the last scroll value that contains the fixed row. Class used to manage various print preview related settings.

Initializes a new Owning control Indicates if the property is different then its default value.

This method returns a boolean indicating whether the has been changed from its default value. The default value is based on the of the associated control.

 True if the property should be serialized. Resets the property to its default value.

This method resets the to its default value. The default value is based on the of the associated control.

 Indicates if the property is different then its default value.

This method returns a boolean indicating whether the has been changed from its default value. The default value is based on the of the associated control.

 True if the property should be serialized. Resets the property to its default value.

This method resets the to its default value. The default value is based on the of the associated control.

 Indicates if the property is different then its default value.

This method returns a boolean indicating whether the has been changed from its default value. The default value is based on the of the associated control.

 True if the property should be serialized. Resets the property to its default value.

This method resets the to its default value. The default value is based on the of the associated control.

 Indicates whether the property needs to be serialized.

This method returns a boolean indicating whether the properties of the have been changed from their default values.

 A boolean indicating whether the property needs to be serialized. Resets the property to its default value.

This method resets the properties of the to their default values.

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

 Indicates if the property is different then its default value.

This method returns a boolean indicating whether the has been changed from its default value. The default value is based on the of the associated control.

 True if the property should be serialized. Resets the property to its default value.

This method resets the to its default value. The default value is based on the of the associated control.

 Invoked when the object is disposed. Invoked when a property on a subobject has changed. Contains information about the property change Converts the object to a string Returns or sets a value indicating how the should be calculated.

The ZoomMode determines how the pages are scaled and includes values that either indicate that the should be honored (Standard or AutoFlow), or whether the pages should be automatically scaled regardless of the Zoom.

 Returns or sets the magnification of the preview pages.

The Zoom property is used by the derived controls to determine how the pages are scaled. The property must be set to Standard or AutoFlow in order for the Zoom property to be used.

 Returns or sets the number of columns of preview pages displayed.

The Columns property is used to determine the number of columns of preview pages that will be displayed in the associated or .

Note: When the is set to AutoFlow, the number of columns will be based on the property and the number of pages that can fit in the visible area up to the value of the Columns property. In that case, the Columns value will be used as the maximum number of columns.

 Returns or sets the number of rows of preview pages displayed.

When set to 0, which is the default value, the pages will be arranged in a continuous flow from left to right and top to bottom. When this property is set to 1 or higher, that will be used to indicate the maximum number of rows per "view". A view is considered a group of preview rows that can be viewed at the same time.

 Returns or sets a value indicating where page numbers are displayed in the preview.

The PageNumberDisplayStyle determines where page numbers are displayed relative to the preview pages. The default value for this property depends upon the associated control. For an , the property defaults to None so page numbers are not displayed. For an , the property defaults to left of row so space is left to the left of the pages and a single page number for each row of pages is displayed containing the page number of the first page in the row. The last available value for this property is BelowEachPage in which case the page number is displayed beneath each preview page.

 Returns or sets the borderstyle rendered around the control.

The BorderStyle property determines the border that is rendered around the client area of the control. By default, a value of Inset is used if the property not set.

 Object used to modify the appearance of the scroll bars.

The ScrollBarLook contains properties that affect the appearance of the horizontal and vertical scrollbar within the associated derived controls.

Note: When the operating system supports themes and is set to true, the appearances of the ScrollBarLook will not be applied.

 Returns or sets when the horizontal scrollbar is displayed.

The ShowHorizontalScrollBar is used to determine whether the horizontal scrollbar in the associated should be displayed. By default, the scrollbar is only shown when needed (i.e. Automatic).

Note: When this property is set to Automatic, which is the default value, the scrollbar will be displayed if the is set to a value that will cause the to be automatically calculated (e.g. PageWidth, WholePage, etc.).

 Returns or sets when the vertical scrollbar is displayed.

The ShowVerticalScrollBar is used to determine whether the vertical scrollbar in the associated should be displayed. By default, the scrollbar is only shown when needed (i.e. Automatic).

Note: When this property is set to Automatic, which is the default value, the scrollbar will be displayed if the is set to a value that will cause the to be automatically calculated (e.g. PageWidth, WholePage, etc.).

 Returns or sets the appearance used to render the background appearance for the control.

The Appearance property is an that is used as the default appearance information when the associated .

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns or sets the appearance used to render the page.

The PageNumberAppearance is an that is used to render the page elements in the associated .

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns or sets the appearance used to render the page number.

The PageNumberAppearance is an that is used to render the page number elements (see ) in the associated .

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns or sets the appearance used to render the .

The CurrentPageNumberAppearance is an that is used to render the preview page of the in the associated control.

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns or sets the appearance used to render the page number for the .

The CurrentPageNumberAppearance is an that is used to render the preview page number (see ) of the in the associated control.

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns or sets whether the control takes focus.

The AcceptsFocus property is used to determine whether the control can receive focus. The default value for this property depends upon the associated . For an , this property is set to true so that the control can accept focus and be navigated using the keyboard. When set to false, the control will not be able to be navigated to using the keyboard. For an , this property defaults to false.

 Returns or sets whether the preview page displayed is updated while the vertical scrollbar thumb is being dragged.

The ScrollMode property is used to determine whether vertical scrolling within the associated is immediate or deferred. When set to Immediate, the display containing the preview pages is updated to display the preview pages based on the scroll position during the drag of the scrollbar thumb. When set to Deferred, the display will contain the preview pages that were displayed prior to starting the drag operation and will only update once the scrollbar thumb has been released.

Note: The setting for this property affects the . For more information, please refer to the property.

 Returns or sets whether a scroll tip will be displayed as the scroll thumb is dragged.

The ScrollTipStyle property is used to determine whether a tooltip containing the page number is displayed while the vertical scrollbar thumb is being dragged in the associated . When set to Show, a tooltip is displayed when the scroll thumb is dragged and remains in place during the drag operation until the drag is complete. While the scroll thumb is dragged, the estimated page number is displayed in the tooltip.

Note: The default setting for this property is affected by the . For more information, please refer to the property.

 Returns or sets whether mouse panning using the middle mouse button is supported.

The MousePanning property is used to determine if/how the control should be allowed to scroll while the middle mouse button is pressed over the client area of the control. By default, both horizontal and vertical mouse panning is allowed although the default value may be affected by the current .

 Converts the object to a string Control for displaying a preview of an

The UltraPrintPreviewControl is a specialized that is used to generate and display print preview pages. The control may be used in association with an , which when associated with the UltraPrintPreviewControl via its , can be used to change which pages are displayed in the preview control.

The property is used to specify which will provide the preview pages. By default, the preview pages will be generated when the pages are initially requested - usually once the control is rendered although this can be prevented using the property. While the preview operation is in progress, a status dialog is displayed that indicates the page number being printed and has a cancel button that can be used to cancel the print operation. This dialog can be suppressed using the property. Once the print operation is complete, the event is invoked.

The UltraPrintPreviewControl also includes the ability to use the mouse to change the zoom, zoom in on a particular area, place a snapshot of a portion of a page to the clipboard, or scroll based on the property.

The control also includes support for a view history. The view history are snapshots of the scroll position and zoom settings at various points. These snapshots are automatically taken as the end-user scrolls, changes the zoom, drags the viewbox of the associated control, etc. As the view history changes, the event is invoked. The and properties can be used to determine whether the end-user can navigate to a previous or next item in the view history. The method can be used to navigate back and forward in the view history (using actions of PreviousView and NextView respectively) or clear the view history (using an action of ClearViewHistory).

 Abstract case class for a control that displays print preview pages.

The UltraPrintPreviewControlBase is an abstract base class for controls that display print preview pages. Currently, there are two controls that derive from this base class - and .

The property returns an object that contains many commonly used properties for adjusting the display of the control and preview pages.

 Initializes a new

Returns a Boolean value that determines whether the property is set to its default value.

This method returns true if any properties on the have been changed from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

 Invoked when a property on a subobject has changed. Contains information about the property change Invoked during the of the component. Invoked during the of the component. Invoked when the preview pages have changed. Returns the size of the specified page Index of the page to evaluate The preview page at the specified index Creates an accessible object for a preview page. The 0 based index representing the page number. A new object for the page. Called when the app-style changes. Used to invoke the event Event arguments Handles the resize of the control. System.EventArgs Invoked when the component must release the resources it is using. True if managed resources should be released. Invoked when the mouse wheel is rotated. Event arguments Invoked when the font property of the control has been changed. System.EventArgs Determines if the should be serialized. True if the forecolor is ControlLightLight. Resets the to its default value. Determines if the should be serialized. True if the backcolor is ControlDark. Resets the to its default value. Creates a new accessibility object for the control. A new for the control. Raises the event. An instance that provides data for the event.

Raising an event invokes the event handler through a delegate.

The OnCurrentZoomChanged method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnCurrentZoomChanged in a derived class, be sure to call the base class's OnCurrentZoomChanged method so that registered delegates receive the event.

 Raises the event. An instance that provides data for the event.

Raising an event invokes the event handler through a delegate.

The OnCurrentPageChanged method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnCurrentPageChanged in a derived class, be sure to call the base class's OnCurrentPageChanged method so that registered delegates receive the event.

 Returns the border style used by the control

This is a read-only property that indicates the that the control will use to render the border around the control. By default an inset border is displayed around the control.

 Returns the resolved value that indicates whether the contents of the preview are updated while the vertical scroll thumb is repositioned.

This is a read-only property that returns the resolved value indicating whether the preview pages are displayed while the vertical scroll thumb is dragged (i.e. Immediate) or if the pages displayed prior to the start of the drag operation remain visible until after the scroll thumb has been released (i.e. Deferred). When the of the has been set to a value of zero, which indicates that the pages are arranged in a continuous flow, this property will default to Immediate, otherwise this defaults to Deferred.

 Returns the resolved value that indicates whether a scroll tip will be displayed as the scroll thumb is dragged.

This is a read-only property that returns the resolved value indicating whether a scroll tip will be displayed when the vertical scroll thumb is dragged. By default, the ScrollTipStyleResolved is based on the . When the ScrollMode is Deferred, this property defaults to Show, otherwise it resolves to Hide.

 Returns the resolved value that indicates whether mouse panning is supported.

This is a read-only property that returns the resolved value indicating whether mouse panning is supported by the control. By default, both horizontal and vertical panning is enabled unless the returns Deferred in which case only Horizontal panning is enabled.

 Returns an object used to modify settings for the print preview.

The Settings property returns an instance of a class. The settings of this object are used to change common preview settings such as the maximum number of and that are displayed within the control.

 Returns the number of pages in the preview

This is a read-only property that returns an integer value indicating the number of preview pages that will be displayed by the control.

 Returns the resolved zoom level for the pages currently in view.

This is a read-only property that returns a double value indicating the current zoom level at which the preview pages are being displayed.

 Returns the first page which contains the largest portion of its visible area in view.

This is a read-only property that return an integer indicating the first page that contains the largest portion of its visible area in the control. The value returned is 1-based. If there are no pages in the control (i.e. returns 0, -1 will be returned.

 Returns a boolean indicating if any pages prior to the can be scrolled into view.

This is a read-only property that returns a boolean indicating if there are any pages before the that may be scrolled into view.

 Returns a boolean indicating if there are any pages after the that can be scrolled into view.

This is a read-only property that returns a boolean indicating if there are any pages after the that may be scrolled into view.

 Returns a boolean indicating if the zoom can be increased using the PerformAction method.

This is a read-only property that returns a boolean indicating if the can be set to a higher value using the PerformAction method.

 Returns a boolean indicating if the zoom can be decreased using the PerformAction method.

This is a read-only property that returns a boolean indicating if the can be set to a lower value using the PerformAction method.

 Overriden. This property is obsoleted. Please use object's BackColor property instead. For internal use only. Used for serializing out the BackColor property value. This is strictly for backward compatibility. The minimum zoom level for the control The maximum level for the control. The default zoom level for the control. Returns the actual minimum zoom that the control may use Returns the actual maximum zoom that the control may use The default for the control The default value for the control The default acceptsfocus value for the control Returns the message that will be displayed in the page area. Handler used to hook into the SubObjectPropChange event of subobjects. Notifications are sent to the method. Returns an array of the default zoom increments. Returns the main that represents the control. Returns the default size for the control - 100,100. Event that occurs when the has been changed.

The CurrentZoomChanged is invoked when the resolved zoom used to display the currently visible pages has been changed. This can occur because the or has changed or when scrolling between one set of visible pages to another depending upon the and of the associated instance.

 Event that occurs when the has been changed.

The CurrentPageChanged is invoked when the property has changed.

 Overriden. Determines the default ImeMode for the control. Determines the ImeMode for the control. Overriden. The BackgroundImage for the control should be set via the property. Text property - Not supported. TextChanged event is not used for the UltraPrintPreviewControl BackgroundImageChanged event is not used for the UltraPrintPreviewControl ImeModeChanged event is not used for the UltraPrintPreviewControl Accessible object representing a . Initializes a new Associated control Retrieves the accessible child corresponding to the specified index. The zero-based index of the accessible child. An AccessibleObject that represents the accessible child corresponding to the specified index. Retrieves the number of children belonging to an accessible object. The number of children belonging to an accessible object. Retrieves the child object at the specified screen coordinates. The horizontal screen coordinate. The vertical screen coordinate. An AccessibleObject that represents the child object at the given screen coordinates. This method returns the calling object if the object itself is at the location specified. Returns a null reference (Nothing in Visual Basic) if no object is at the tested location. Gets the role of this accessible object. Accessible object representing a single page in a . Initializes a new Index of the associated page. Associated control Returns the control used to synchronize accessibility calls. Performs the default action associated with this accessible object. Retrieves the number of children belonging to an accessible object. The number of children belonging to an accessible object. Retrieves the child object at the specified screen coordinates. The horizontal screen coordinate The vertical screen coordinate. Navigates to another accessible object One of the AccessibleNavigation values An AccessibleObject that represents one of the AccessibleNavigation values Gets the location and size of the accessible object Gets a string that describes the default action of the object. Not all objects have a default action. Gets a string that describes the visual appearance of the specified object. Not all objects have a description. Returns the name of the accessible object. Gets the parent of an accessible object Returns the role of the accessible object. Returns the state of the accessible object. Initializes a new Used to verify/force the creation of the preview pages.

The GeneratePreview method is used to synchronously cause the generation of the preview pages. By default, the pages will be generated when pages are requested although the automatic generation of pages can be prevented by setting the to false.

 If true, any existing preview information will be discarded and the preview will be regenerated. If false, the preview will only be generated if it has not already been generated. Used to dirty the preview information so that it will be regenerated upon the next request.

This method is used to explicitly dirty the cached preview information. When the preview information is subsequently requested, the preview pages will be generated.

 Performs an action, simulating user input via keyboard or mouse.

PerformAction simulates user interaction with the control. Calling Peformaction will cause the control to behave as through the user performed the specified action. Any appropriate events will be called as if the user performed the action.

 The action to perform. True if action was performed. Invokes Print on the associated .

The Print method is used to invoke the method. The parameter is used to determine which printcontroller will be used for the print operation. If is false, then the is used, otherwise the UltraPrintPreviewControl's custom status print controller is used.

 A boolean indicating whether to display a status dialog during the print operation. Raises the event when the preview pages have been generated. A that provides data for the event.

Raising an event invokes the event handler through a delegate.

The OnPreviewGenerated method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnPreviewGenerated in a derived class, be sure to call the base class's OnPreviewGenerated method so that registered delegates receive the event.

 Raises the event when the preview pages have been generated. A that provides data for the event.

Raising an event invokes the event handler through a delegate.

The OnViewHistoryChanged method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnViewHistoryChanged in a derived class, be sure to call the base class's OnViewHistoryChanged method so that registered delegates receive the event.

 Raises the event when the preview pages have been generated. A that provides data for the event.

Raising an event invokes the event handler through a delegate.

The OnSnapshotCreated method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnSnapshotCreated in a derived class, be sure to call the base class's OnSnapshotCreated method so that registered delegates receive the event.

 Invoked during the of the component. Returns the size of the specified page Index of the page to evaluate The preview page at the specified index Indicates whether the control should receive mouse notifications at design time based on the specified location. The location to evaluate (in client coordinates) True if the control should receive mouse notifications for the specified location. Invoked when the component must release the resources it is using. True if managed resources should be released. Invoked when the control's Handle has been created. Event arguments Handles the message notification when the control loses focus. Handles the message notification when a key is pressed Event arguments Handles the message notification when a key is released Event arguments Returns true if the key is a valid input key for this control Factory method used to create the component role that provides the style information for the control. Returns or sets the document that will be previewed.

The Document property is the that is used to provide the print preview pages that will be displayed by the control.

Note: Changing this property will cause the entire preview to be regenerated.

 Returns or sets whether the print preview will be rendered using anti aliasing.

This property is used to determine whether the print preview will be rendered using anti-aliasing. By default, anti-aliasing is not used.

Note: Changing this property will cause the entire preview to be regenerated.

 Returns or sets whether a dialog will be displayed while the preview pages are being generated.

By default, when a print operation is running a status dialog is displayed. This dialog indicates the page that is being printed and also includes a button that can be used to end the operation. If you do not want to display this dialog, you must set the DisplayPreviewStatus property to false.

 Returns or sets whether the preview is automatically created when the document is changed and when the control is first displayed.

The AutoGeneratePreview property is used to determine whether the control should automatically create the print preview pages when they are needed. Normally, the preview pages are automatically generated when the control is rendered. You can set this property to false to prevent that behavior. You would then need to explicitly call the when you want the preview pages to be synchronously generated.

 Returns or sets the maximum number of preview pages that should be generated.

The MaximumPreviewPages is used to restrict how many pages will be created when the print operation is performed and therefore how many pages may be displayed by the control.

Note: Changing this property after the print preview operation has completed will not affect how many pages are displayed but instead will affect the next print operation, if one occurs.

 Returns or sets how the control will react to the left mouse button.

The MouseAction is used to determine how the control will react while it has the input focus. When used with a value of Hand, the left mouse button may be pressed on a page and dragged to scroll the visible area. A value of Snapshot is used to allow the end-user to click on or lasso an area of a page that should be copied to the clipboard. The area is copied using the current zoom value.

The MouseAction also includes several options for controlling the current using the mouse. When DynamicZoom is used, the mouse may be pressed and dragged up or down to synchronously zoom in or out respectively. When ZoomIn is used, the end-user can either click on a page to zoom in at a set increment or they may lasso the area that they want to zoom into. Lastly, when ZoomOut is used, the end-user can either click on a page to zoom out to a fixed increment or they may lasso an area that is used to determine the new zoom level.

 Returns the resolved mouse action.

This is a read-only property that returns the resolved value that is used by the control to determine what action is taken when the mouse buttons are used. If there are no pages in the preview then an action of None is returned. When the is set to ZoomIn or ZoomOut, the Control key may be used to temporarily toggle the mouse action to the opposite value. Also, if the Shift key is pressed while the MouseAction is set to one of these two values, the control will temporarily use a mouse action of DynamicZoom

 Returns bit flags that signify the state of the control

This is a read-only property that returns a flagged enumeration which indicates the current states of the control.

 The mappings collection that relates key strokes with actions.

The following table lists the default key mappings for the control:

KeyCode ActionCode StateRequired StateDisallowed SpecialKeysRequired SpecialKeysDisallowed
PriorScrollPageUpPagesAll
PriorScrollToTopPagesShiftCtrl
NextScrollPageDownPagesAll
NextScrollToBottomPagesShiftCtrl
HomeScrollToTopPages
EndScrollToBottomPages
UpScrollUpPagesAll
UpScrollToTopPagesShiftCtrl
DownScrollDownPagesAll
DownScrollToBottomPagesShiftCtrl
AddZoomInPagesCtrl
SubtractZoomOutPagesCtrl
SpaceScrollPageDownPages, MouseActionHandAll
LeftScrollToPreviousPagePagesAll
RightScrollToNextPagePagesAll

Returns a boolean indicating if there is a previous entry in the history/viewing path.

As the view of the UltraPrintPreviewControl changes, a history is maintained of the areas of the pages that have been viewed. This is the view history. The HasPreviousView and are used to indicate if there are entries in the specified direction within the view history. The can then be used with values of PreviousView and NextView respectively to navigate within the view history.

Note: There is a limit on the history depth that will be maintained. Once that depth is reached, subsequent history entries will remove the earliest entries as needed.

 Returns a boolean indicating if there is a next entry in the history/viewing path.

As the view of the UltraPrintPreviewControl changes, a history is maintained of the areas of the pages that have been viewed. This is the view history. The and HasNextView are used to indicate if there are entries in the specified direction within the view history. The can then be used with values of PreviousView and NextView respectively to navigate within the view history.

Note: There is a limit on the history depth that will be maintained. Once that depth is reached, subsequent history entries will remove the earliest entries as needed.

 Returns an array of the default zoom increments. Occurs when the preview information have been generated.

The PreviewGenerated is used to notify listeners of when the preview pages have been generated. This event is useful since by default the preview pages are only generated when the page information has been requested (internally or externally).

 Occurs when the view history has changed.

The ViewHistoryChanged is used to notify listeners when the view history has changed. The view history is an internally managed list of changes in the view. This can include scrolling, changing the zoom, dragging the viewbox of the , progratically going forward or backward through the view history (i.e. using the ), etc. This event can be used to know when to check the and properties.

 Occurs when a snapshot of a page or the page area is copied to the clipboard.

When the is set to Snapshot, the mouse may be dragged to lasso a section of a page that should be copied to the clipboard or the user can mouse down and up in the same location to copy the entire page to the clipboard. The SnapshotCreated is invoked after a snapshot has been copied to the clipboard.

Note: The ability to copy to the clipboard will depend upon the rights available as well as any other restrictions placed on using the class.

 Returns the number of pages in the preview

This is a read-only property that returns an integer value indicating the number of preview pages that will be displayed by the control.

 The minimum zoom level for the control The maximum zoom level for the control. The maximum zoom level for the control. The default zoom mode for the control The default acceptsfocus value for the control The default acceptsfocus value for the control Returns the message that will be displayed in the page area. Displays the About dialog for the control. Return the license we cached inside the constructor Designer used by -derived classes. Gets the for this designer's control/component. Provides DesignerActionItems for the SmartTag associated with the UltraPrintPreviewThumbnail. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Provides DesignerActionItems for the SmartTag associated with the UltraPrintPreviewThumbnail. Constructor Overrides CreateActionItems. The list to populate. Used by SmartTag Panel. Used by SmartTag Panel. Used by SmartTag Panel. Control for displaying thumbnail views of the print preview pages displayed by an associated

The UltraPrintPreviewThumbnail is a derived control that is specialized for interacting with an associated . The is used to indicate which UltraPrintPreviewControl will provide the preview pages. Clicking on pages within UltraPrintPreviewThumbnail will cause the associated page within the PreviewControl to be scrolled into view.

The control includes the capability to display a "viewbox" within its preview pages. This viewbox indicates which portions of the pages within the associated PreviewControl are currently in view. The is used to indicate which pages should display the viewbox. The may be used to control the appearance of the viewbox displayed within the pages. In addition, the may be used to control how the view box may be dragged. Dragging the viewbox updates the pages displayed within the . It is also possible to affect the pages displayed by the PreviewControl by clicking on a page in the preview or by clicking on the page number ().

 Initializes a new

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

Returns a Boolean value that determines whether the property is set to its default value.

This is a read-only property that returns a boolean indicating if any properties of the of the have been modified from their default values.

 Resets the property to its default value.

Resets the property values of the to their default values.

 Performs an action, simulating user input via keyboard or mouse.

PerformAction simulates user interaction with the control. Calling Peformaction will cause the control to behave as through the user performed the specified action. Any appropriate events will be called as if the user performed the action.

 The action to perform. True if action was performed. Invoked when the component must release the resources it is using. True if managed resources should be released. Returns the size of the specified page Index of the page to evaluate The preview page at the specified index Invoked when a property on a subobject has changed. Contains information about the property change Returns true if the key is a valid input key for this control Factory method used to create the component role that provides the style information for the control. Returns or sets the associated that will provide the preview information and will be updated when the thumbnail is changed.

The PreviewControl is used to associate the with the whose preview pages it will be displaying.

 Returns or sets the appearance used to render the view box. The view box is the area within a page that indicates what portion of a page is currently in view in the associated preview control.

The viewbox is the area within the preview pages of the that indicates the pages currently in view within the associated .

Currently the is Solid so the will not affect the appearance of the viewbox.

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns bit flags that signify the state of the control

This is a read-only property that returns a flagged enumeration which indicates the current states of the control.

 The mappings collection that relates key strokes with actions.

The following table lists the default key mappings for the control:

KeyCode ActionCode StateRequired StateDisallowed SpecialKeysRequired SpecialKeysDisallowed
PriorScrollPageUpPagesAll
PriorScrollToTopPagesShiftCtrl
NextScrollPageDownPagesAll
NextScrollToBottomPagesShiftCtrl
HomeScrollToTopPages
EndScrollToBottomPages
UpScrollUpPagesAll
UpScrollToTopPagesShiftCtrl
DownScrollDownPagesAll
DownScrollToBottomPagesShiftCtrl
LeftScrollToPreviousPagePagesAll
RightScrollToNextPagePagesAll

Returns or sets the appearance used to render the page number for the of the associated .

The CurrentPreviewPageNumberAppearance is an that is used to render the page number (see ) of the in the associated .

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns or sets the appearance used to render the page for the of the associated .

The CurrentPreviewPageNumberAppearance is an that is used to render the preview page of the in the associated .

 Returns a Boolean value that indicates whether an object has been created.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

 Returns or sets a value indicating where the view box will be displayed in the thumbnail pages.

The ViewBoxDisplayStyle determines which preview pages, if any, will include a viewbox element. The viewbox element indicates what portion of that page is currently displayed within the associated .

 Returns or sets a value indicating where the view box may be dragged within the page.

The ViewBoxDragMode is used to determine whether the view box may be repositioned with the preview pages. The viewbox is an area with a preview page that indicates the portion of the corresponding page in the is currently in view. Dragging the view box will change the preview pages that are currently in view with the associated PreviewControl.

 Returns the resolved setting.

This is a read-only property which returns the resolved . By default, Free is returned unless the Control key is held down, in which case RestrictWithinPage is returned.

 Returns the number of pages in the preview

This is a read-only property that returns an integer value indicating the number of preview pages that will be displayed by the control.

 The minimum zoom level for the control The maximum zoom level for the control. The default zoom level for the control. The default zoom mode for the control The default acceptsfocus value for the control The default acceptsfocus value for the control Returns the message that will be displayed in the page area. Returns an array of the default zoom increments. Displays the About dialog for the control. Return the license we cached inside the constructor Enumeration of common property id's

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a control and responding to those changes. All controls derived from expose this functionality.

property property property property property property property property property property property property Enumeration of property id's

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a control and responding to those changes. All controls derived from expose this functionality.

property property property property property property property property property property Enumeration of property id's

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a control and responding to those changes. All controls derived from expose this functionality.

property property property Enumeration of property ids for the control

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a control and responding to those changes. All controls derived from expose this functionality.

Enumeration of property ids for the

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a control and responding to those changes. All controls derived from expose this functionality.

property Property ids for the and its associated classes

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a component and responding to those changes. All components derived from expose this functionality.

property property property property property property property property property Enumeration of property id's

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a control and responding to those changes. All controls derived from expose this functionality.

The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. The property. Enumeration of property ids for the and its derived controls

Property identifiers are passed to handlers of the event. This provides a generic technique for both receiving notification of changes in the state of a control and responding to those changes. All controls derived from expose this functionality.

property property property property property property property property property property property property property property property property property property property property property property property property property property property property property property property Exposes a instance for this assembly. Returns the resource string using the specified name and default culture. Name of the string resource to return. Arguments supplied to the string.Format method when formatting the string. Returns the resource string using the specified resource name and default culture. The string is then formatted using the arguments specified. Name of the string resource to return. Returns the resource object using the specified name. Name of the resource item An object containing the specified resource Returns the for this assembly. Returns the localized category name Name of the category to retreive The localized string value Return the list of products that this control can be licensed with Helper class with static methods