sGenericBox Semantic Component

Contents

 Introduction

An sGenericBox can only be the child of a record-box canvas, such as an sHBox.

Interaction between the sGenericBox and the sHBox

In the schema above, the sHBox is a record-box. This means that all the attributes of the record are bound to the child component of that sHBox. All attributes of the record that can't be bound to any child component of the sHBox will be bound to the sGenericBox. The goal of the sGenericBox is simply to be the fallback to use to display all the information for a given record, even if the record has been described using attributes/values that are not currently handled by the application.

Once the sHBox determines all of the unbound attributes, the sGenericBox takes that list of unbounded attribute and tries to display the value(s) of each of them. It will create create two things: an sText that will display the preferred label of the unbounded attribute, and an sControl that will try to display the value(s) of that unbounded attribute. If no Semantic Control can be used to display the value of an unbounded attribute, it will simply use the sText to display the text representation of the value of the unbound attribute.

 Styles

Style Name Description
sGenericBox Style for the main sGenericBox component

 AS3 Usage Examples

  /** Create a resultset object instance from the input structXML data */
  var resultset:Resultset = new Resultset(XML(inputData));

  /** Create the sGenericBox component */
  var semanticGenericBox:sGenericBox = new sGenericBox();

  /** Initialize the semantic control */
  semanticGenericBox.percentWidth = 100;
  semanticGenericBox.percentHeight = 100;
  semanticGenericBox.semanticDataProvider = resultset;

  /** Add the sGenericBox to the main application */
  this.addChild(semanticGenericBox);

 MXML Usage Examples

 <sGenericBox id="testSemanticControl"
               semanticDataProvider="{semanticDataProvider}"
               width="100%"
               height="100%" />

In this example, we assume that the {semanticDataProvider} variable is a Resultset, where the record description is defined, accessible at the creation time of the sGenericBox.

 Related Libraries

No related external libraries.