StringList Method Call

A StringList Method Call is a Complex Method Call that returns a StringList.

• See Methods for explanations of the basics and for Code examples and for the declaration of Method Calls.
  See How to use Method Calls for general information on using Method Calls.
• Go to the complete list of all Complex Method Calls 

Code Example

The example exists of an Operation and a Form. In the operation the Entity Collection(s) and Dataview(s) are defined. The definitions of Lists and Method Call(s) for composing the data, based on input from the user, are also defined in the Forms.

Code example Operation

protected override IForm CreateStartupForm()
{
   return new StringListMethodCallDemoFrm(this);
}

public IEntityCollection<StringListMethodCallDemoEntity> StringList
{
   get { return Property(() => new VolatileTable("string list").Select<StringListMethodCallDemoEntity>().All()); }
}

public IDataView<StringListMethodCallDemoEntity> StringListView
{
   get { return Property(() => StringList.ToView()); }
}

Explanation Code example Operation

1. Lines 1-4: Definition of the Form (see code of the Form below).
2. Lines 6-9: Definition of a Volatile Table. We fill this in the Form (below).
3. Lines 11-14: Definition of the View, which is used to display the data in the Form.
4. Lines 8 and 11: The necessary StringListMethodCallDemoEntity is defined elsewhere. Type 'Volatile Table' in the Search box to read more about the working of the Volatile Table.
5. This StringListMethodCallDemoEntity is also used in the Form below, on line 14.
   
   

Code example Form

public StringListMethodCallDemoFrm(StringListMethodCallDemoOp operation) : base(operation)
{

}

protected override IUIElement CreateGui()
{
   return new VBox
   {
       new HBox
       {
           new GroupBox("example",2, alignV:AlignV.Top)
           {
               new DataGrid<StringListMethodCallDemoEntity>(Operation.StringListView, showColumnHeaders:false)
               {
                   e => e.Description
               }
           }
       },

       new HBox(alignH:AlignH.Fill)
       {
           new Button(GetStringList()),
           EmptySpace.FillH,
           new Button(Close())
       }
   };
}

private StringList ComposeStringList()
{
   return Method<StringList>(() => 
   {
       var list = new StringList();
       return new Body
       {
           list.Add("hello world"),
           list.Add("pizza"),
           list.Add("potato"),
           list.Add("apple"),
           list.Add("pear"),
           new Return(list)
       };
   });
}

private IMethodCall GetStringList()
{
   return Method(() =>
   {
       var newListItem = Operation.StringList.CreateItemReference();
       return new Body
       {
           Operation.StringList.DeleteAll(),
           ComposeStringList().Foreach(listItem => new Body
           {
               newListItem.Assign(Operation.StringList.New()),
               newListItem.Description.Assign(listItem)
           })
       };

   })
   .SetWorkDescription("get string list")
   .SetImage(WikiImages.Directory)
   .Call();
}

Explanation Code example Form

• Lines 6-28: The definition of the form.
  
• Line 14: The View, based on the Entity (see explanation 3 and 4 of the Operation), are passed to a DataGrid.
• Lines 30-45: This is a private property of the type StringList. In it, the list is composed (lines 37-41) and returned (Line 42). This StringList was defined in the Operation as a Volatile Table.
• Lines 47-66: This MethodCall, named GetStringList(), starts a new instance of StringList on line 51.
• In line 54 any previous data is deleted. Then a new list is created by looping through the StringList (see lines 30-45) and assigning the value to the listItems (line 58).

Example of the result

A form like the one defined above, could look like this.

When starting the application:

After clicking the button: