Advanced programming

collapse

#
- 1.) Application.config
- 2.) Basic concepts
  - 1.) Composite pattern
    - 1.) Lifecycle
    - 2.) Programming
  - 2.) Properties
    - 1.) Local
    - 2.) Network
    - 3.) Persistance
    - 4.) Configuration
    - 5.) Logging
  - 3.) Synchronous Methods
    - 1.) Virtual methods
  - 4.) References
    - 1.) 1 Object
    - 2.) N Objects locally
    - 3.) N Objects Network
  - 5.) Events
  - 6.) Asynchronous methods
  - 7.) Configuration
    - 1.) Config storage
    - 2.) Overriding
  - 8.) Messages and Alarms
    - 1.) Alarms
  - 9.) Database
    - 1.) Usage
    - 2.) Extend
      - 1.) EF 4.0
      - 2.) EF 7.0
    - 3.) Persistable queries
  - 10.) Designs
    - 1.) GUI Design
      - 1.) Set and convert Properties
      - 2.) Styles and Setter
      - 3.) Property trigger
      - 4.) Datatrigger
      - 5.) Events & trigger
      - 6.) Animations
      - 7.) Resources
    - 2.) Reports
      - 1.) Programming
  - 11.) Diagnose and Debugging
  - 12.) Updates
- 3.) UI-Controls
  - 1.) UI-Library integration
  - 2.) iPlus-Controls
  - 3.) Custom Controls
- 4.) Application programming
  - 1.) Multithreading
  - 2.) Businessobjects
    - 1.) Navigationless
    - 2.) Navigable
    - 3.) Context dependant dialogs
    - 4.) Background Tasks
  - 3.) Manager classes
  - 4.) Process applications
  - 5.) Workflow classes
  - 6.) External systems
    - 1.) Mobile devices
    - 2.) OPC UA Communication
      - 1.) Server
    - 3.) Simatic S7
  - 7.) Bit masking
- 5.) []

;

Predefined methods

Navigation-less business objects are intended for programs with which no data records are created, searched for or deleted. You can still work with a database context. The following buttons on the ribbon are intended for navigable as well as navigable business objects:

**Commands on the ribbon**
Icon	method
	This button is used for printing. The VBContent is "! QueryPrintDlg" . This method is already pre-declared in ACBSO and does not have to be declared explicitly in the derivation. [ACMethodCommand("Query", "en{'Print'}de{'Drucken'}", (short)MISort.QueryPrintDlg)] public void QueryPrintDlg()
	This button is used to preview the print. The VBContent is "! QueryPreviewDlg" . This method has already been declared in ACBSO and does not have to be declared explicitly in the derivation. [ACMethodCommand("Query", "en{'Preview'}de{'Vorschau'}", (short)MISort.QueryPreviewDlg)] public void QueryPreviewDlg()
	This button is used to manage and edit reports. The VBContent is "! QueryDesignDlg" . This method is already pre-declared in ACBSO and does not have to be declared explicitly in the derivation. [ACMethodCommand("Query", "en{'Design'}de{'Entwurf'}", (short)MISort.QueryDesignDlg)] public void QueryDesignDlg()
	This button is used to cut out selected content. The VBContent is "! Cut" . This method is not declared in the business objects, but in certain UI controls that support clipping. [ACMethodInteraction("", "en{'Cut'}de{'Ausschneiden'}", (short)MISort.Cut, false)] public new void Cut()
	This button is used to copy selected content. The VBContent is "! Copy" . This method is not declared in the business objects, but in certain UI controls that support copying. [ACMethodInteraction("", "en{'Copy'}de{'Kopieren'}", (short)MISort.Copy, false)] public new void Copy()
	This button is used to insert selected content. The VBContent is "! Paste" . This method is not declared in the business objects, but in certain UI controls that support insertion. [ACMethodInteraction("", "en{'Paste'}de{'Einfügen'}", (short)MISort.Paste, false)] public new void Paste()
	This button is used to undo the last change. The VBContent is "! Undo" . This method is not declared in the business objects, but in certain UI controls that support undo. [ACMethodInteraction("", "en{'Undo'}de{'Rückgängig'}", (short)MISort.Undo, false)] public new void Undo()
	This button is used to restore. The VBContent is "! Redo" . This method is not declared in the business objects, but in certain UI controls that support restoring. [ACMethodInteraction("", "en{'Redo'}de{'Wiederholen'}", (short)MISort.Redo, false)] public new void Redo()

Properties and surface

In order to display and change properties of business objects on the interface, the following things must be taken into account:

Declare public properties with getter and setter.
Publish your property using the ACPropertyInfo attribute class .
Raise the PropertyChanged event when the value of your property has changed. Since ACComponents implement the INotifyPropertyChanged interface , you only have to call the method .void OnPropertyChanged(string name)

Sample code in the BSO

private string _ExampleProp;
[ACPropertyInfo(201, "", "en{'Example'}de{'Beispiel'}", "", false)]
public string ExampleProp
{
  get { return _ExampleProp; }
  set
  {
    _ExampleProp = value;
    OnPropertyChanged("ExampleProp");
  }
}

Sample code in XAML

e.g. <Grid>... 
<vb:VBTextBox VBContent="RunScheduler"/> 
...</Grid>

Data Collections and Interface

In order to display and change data collections of business objects on the surface, the following things must be taken into account:

Declare two properties. One for the data collection and one for the selected element from the data collection.
Publish the data collection with the ACPropertyList attribute class and selection property with the ACPropertySelected attribute class .
Trigger the PropertyChanged event when the value of your selection property has changed. Since ACComponents implement the INotifyPropertyChanged interface , you only have to call the method . You can also trigger the PropertyChanged event for data collection, then the iplus control element implemented by IVBSource updates itself. Your data collection can be a simple list and does not necessarily have to implement INotifyCollectionChanged .void OnPropertyChanged(string name)

Sample code in the BSO

Sample code in XAML

Take a look at the example code in the IVBSource chapter.

Cookie settings