NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

RichControl Properties

The properties of the RichControl class are listed below. For a complete list of RichControl class members, see the RichControl Members topic.

Public:

AccessibilityObject The Accessibility Object for this RichControl
AccessibleDefaultActionDescription The default action description of the control
AccessibleDescription The accessible description of the control
AccessibleHelpProvider The help provider for this RichControl
AccessibleName The accessible name of the control
AccessibleRole The accessible role of the control
AllowDrop The allowDrop property. If allowDrop is set to true then this control will allow drag and drop operations and events to be used.
AllowTransparency Determines if the control should be allowed to have the opacity adjusted. This is primarily a performance optimization, in that you can always set the opacity to any value, and that will force AllowTransparency to true. However, setting the opacity to any given value will switch the control into layered mode. By setting the AllowTransparency property to false the control will actually switch out of layered mode, which provides better performance if you don't intend to adjust the opacity.
Anchor The current value of the anchor property. The anchor property determines which edges of the control are anchored to the container's edges.
BackColor The background color of this control. This is an ambient property and will always return a non-null value.
BackgroundImage The background image of the control.
BindingManager [To be supplied.]
Bindings Retrieves the bindings for this control.
Bottom (inherited from Control) The bottom coordinate of this control.
Bounds (inherited from Control) The bounds of this control. This is the window coordinates of the control in parent client coordinates.
CanFocus (inherited from Control) Checks if this control can receive focus. The result is true if the control has a handle and if it and all of its parent controls are both visible and enabled.
CanSelect (inherited from Control) Checks if this control can be selected. The result is true if the control is contained in a form and if all of its parent controls are both visible and enabled.
Capture (inherited from Control) If this control has captured the mouse then this will return true.
CausesValidation (inherited from Control) Indicates whether entering this control causes validation on the controls requiring validation. This is set to false usually for things like the Help button, etc...
ClientRectangle (inherited from Control) The client rect of the control.
ClientSize (inherited from Control) The size of the clientRect.
CompanyName Retrieves the company name of this specific component.
ContainsFocus (inherited from Control) Indicates whether the control or one of its children currently has the system focus.
ContextMenu The contextMenu associated with this control. The contextMenu will be shown when the user right clicks the mouse on the control.
Controls (inherited from Control) Collection of child controls.
Created (inherited from Control) Returns true if the control has been created.
Cursor Retrieves the cursor that will be displayed when the mouse is over this control.
DefaultFont [To be supplied.]
DisplayRectangle (inherited from Control) Returns the client rect of the display area of the control. For the base control class, this is identical to getClientRect. However, inheriting controls may want to change this if their client area differs from their display area.
Disposed (inherited from Control) Indicates that the control has been disposed, and is no longer a valid Windows control even though the object instance is still alive.
Disposing (inherited from Control) Indicates that the control is in the process of being beendisposed, and is no longer a valid Windows control even though the object instance is still alive.
Dock The dock property. The dock property controls to which edge of the container this control is docked to. For example, when docked to the top of the container, the control will be displayed flush at the top of the container, extending the length of the container.
Enabled (inherited from Control) The current enabled state of this control.
Focused (inherited from Control) Returns true if this control has focus.
Font Retrieves the current font for this control. This will be the font used by default for painting and text in the control.
ForeColor The foreground color of the control.
Handle (inherited from Control) The HWND handle that this control is bound to. If the handle has not yet been created, this will force handle creation.
HandleCreated (inherited from Control) Whether or not this control has a handle associated with it.
Height (inherited from Control) The height of this control
IMEMode Specifies a value that determines the IME (Input Method Editor) status of the object when that object is selected.
InvokeRequired Determines if the caller must call invoke when making method calls to this control. Controls in WinForms are bound to a specific thread, and are not thread safe. Therefore, if you are calling a control's method from a different thread, you must use the control's invoke method to marshal the call to the proper thread. This function can be used to determine if you must call invoke, which can be handy if you don't know what thread owns a control. There are five functions on a control that are safe to call from any thread: GetInvokeRequired, Invoke, BeginInvoke, EndInvoke and CreateGraphics. For all other metohd calls, you should use one of the invoke methods.
IsAccessible Indicates whether or not this control is an accessible control i.e. whether it should be visible to accessibility applications.
Left (inherited from Control) The left coordinate of this control.
Location (inherited from Control) The location of this control.
Opacity Determines the opacity of the control. This can only be set on top level controls. Opacity requires Windows 2000 or later, and is ignored on earlier operating systems.
Parent (inherited from Control) The parent of this control.
ProductName Retrieves the product name of this specific component.
ProductVersion Retrieves the product version of this specific component.
RecreatingHandle (inherited from Control) This is true if the control is currently recreating its handle.
Region The Region associated with this control. (defines the outline/silhouette/boundary of control)
Right (inherited from Control) The right coordinate of this control.
RightToLeft This is used for international applications where the language is written from RightToLeft. When this property is true, control placement and text will be from right to left.
Site (inherited from MarshalByRefComponent) Gets or sets the site of the component.
Size (inherited from Control) The size of this control.
TabIndex (inherited from Control) The tab index of this control. A tab index may consist of any valid integer number greater than or equal to zero. If more than one control on the same parent control has the same tab index, the z-order of the controls will be used to determine the order to pick the controls.
TabStop (inherited from Control) A boolean value indicating whether the user can give the focus to this control using the TAB key.
Text (inherited from Control) The current text associated with this control.
Top (inherited from Control) Top coordinate of this control.
TopLevel (inherited from Control) true if this control is a top level window, meaning that it has no parent.
TopLevelControl (inherited from Control) The top level control that contains this control. This doesn't have to be the same as the value returned from getForm since forms can be parented to other controls.
Visible (inherited from Control) Controls whether the control is visible.
Width (inherited from Control) The width of this control.
WindowTarget (inherited from Control) The target of Win32 window messages.

Protected:

CreateParams [To be supplied.]
CreateThreadId (inherited from Control) Retrieves the Win32 thread ID of the thread that created the handle for this control. If the control's handle hasn't been created yet, this method will return the current thread's ID.
FontHeight [To be supplied.]
InternalHandle (inherited from Control) Returns the current value of the handle. This may be zero if the handle has not been created.
ParkingFormHandle [To be supplied.]
RenderRightToLeft [To be supplied.]
RichParent [To be supplied.]
WindowText (inherited from Control) The current text of the Window; if the window has not yet been created, stores it in the control. If the window has been created, stores the text in the underlying win32 control. This property should be used whenever you want to get at the win32 control's text. For all other cases, use the Text property- but note that this is overridable, and any of your code that uses it will use the overridden version in controls that subclass your own.

See Also

RichControl Class | System.WinForms Namespace