DdsButton Class

The DdsButton is a class that defines a single 'button' control for a corresponding attention key or function key defined in DdsRecord.

For a list of all members of this type, see DdsButton Members.

For a short explanation of this class in use, see the DdsButton Description.

Applicable Products:

Monarch, Wings, Mobile RPG

Inheritance Hierarchy



public class DdsButton Inherits System.Web.UI.WebControls.WebControl

Thread Safety

Any public static (Shared) members of this type are safe for multithreaded operations. Any instance members are not guaranteed to be thread safe.


An instance of DdsButton represents a single button control that can be placed anywhere on the form with the characteristics of the corresponding attention key or functions key setting defined in DdsRecord.

The AidKey property is set to a function key defined in DdsRecord.FuncKeys containing the text and response indicators from the property that corresponds to the aidKey value specified. The FieldName property is used for the name of the field the button is emulating.

For example, the FuncKeys property for the containing DdsRecord contains F4 'PROMPT' 04;F6 'ADD' 06 : !30;F11 'Delete' 11 : !30;F12 'Cancel' 12;. If the AidKey property for the DdsButton is set to F12, the getStringFromKey method would return 'Cancel 12', where Cancel is used as the text for the button, and 12 is the response indicator turned on when the input data is transmitted from the browser.

Four styles can be used to control how a DdsButton will appear on the web page. The ButtonStyle property is used for this purpose as follows.

  • Use ButtonStyle Link to create a hyperlink-style button on the Web page. This control has the same appearance as a Hyperlink but has the functionality of a Button.
  • Use ButtonStyle Icon to choose a mobile-friendly icon from the ASNA.urated selection.
  • Use ButtonStyle Image to specify an image as a clickable button on the web page. This appears as an image but has the same functionality as a Button. The Image property will contain the path to this image used.
  • Use ButtonStyle Button to create a standard button with that functionality. The Text property contains the value to be displayed for the button.

Additionally, you can use the OnMouseOverImage property to specify an image that can be displayed when the user rolls the mouse over the button when the ButtonStyle is Image. When set, this property is used instead of the ToolTip property. Position can be set with the VirtualRowCol property.


Namespace: ASNA.Monarch.WebDspF

Assembly: ASNA.Monarch.WebDspF.DLL

Platforms: Windows Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows 7, Windows 8 Pro, Windows 10 Pro