DdsSubfileControl Class

The DdsSubfileControl class is an extension of a DdsRecord and is both the controller and container of a subfile.

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

Applicable Products:

Monarch, Wings

Inheritance Hierarchy



public class DdsSubfileControl Inherits DdsRecord

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 DdsSubfileControl represents an extension of a DdsRecord. A subfile is typically rendered in a classic tabular format with each record in the subfile providing the data for a row and field shown as a column. It is possible to render a subfile records as a sequence of checkboxes, radio buttons, in a drop-down box or a list box. The SubfileStyle property determines the widget(s) to use for rendering the subfile.

Crowded Messages in a Message Subfile

Sometimes when multiple messages appear on a message subfile, a vertical scroll bar appears on the right hand side of the subfile area taking just enough real-state to force the browser to add a horizontal scroll bar to the span. If the subfile control specified that only a single line was to be shown at a time, the scroll bars effectively take all the space available for the subfile, making it impossible for the user to read the messages.

In the Error Message Subfile, there are three elements involved:

  • Subfile Record Format Control
  • Subfile Record Format
  • Message Character Field.


In the following example, these are three id's: MSGCTL, MSGSFL, and MSGSFL_ZMSGKY.

All of these controls should have the adequate dimensions to allow for multiple messages to display comfortably. As you can see from the "HTML" sample, the MSGSFL_ZMSGKY(DdsCharField) has a Width of 656 pixels, but MSGCTL(DdsSubfileControl) and MSGSFL(DdsSubfile) are only 574 pixels wide. You should set them all the same width and that being as large as the space taken by the longest message you expect (measured in pixels). You can also set your subfile page to be more than one on MSGCTL and then the user could see multiple messages at a time. Finally, setting the SubfilePage property to 0 avoids the vertical scroll bar altogether and displays all records on the screen. Refer the DdsSubfileControl Members for more information on specific property setting for controlling the display of messages.

              <mdf:DdsSubfileControlid="MSGCTL" runat="server" style="POSITION: relative"
                Alias="MSGCTL" CssClass="DdsRecord" ms_positioning="GridLayout" Width="574px" Height="20"
                ProgramQ="ZPGMQ" DisplayFields="49" DisplayRecords="49"          
                InitializeRecords="49" SubfilePage="1" SubfileSize="50">
      <mdf:DdsSubfileid="MSGSFL" style="LEFT: 0px; WIDTH: 665px; POSITION: absolute; TOP: 0px;
                HEIGHT: 32px" runat="server" ms_positioning="GridLayout"
                Height="20" Width="574px" CssClass="DdsRecord" Alias="MSGSFL">
         <mdf:DdsCharFieldid="MSGSFL_ZMSGKY" style="LEFT: 8px; POSITION: absolute; TOP: 4px"   
                runat="server" Height="28px" Width="656px" CssClass="DdsSflMsgField"           
                Length="76" Usage="OutputOnly">


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