LinearLayout (Metawidget API Documentation)

java.lang.Object
- org.metawidget.android.widget.layout.LinearLayout

All Implemented Interfaces:

Immutable, AdvancedLayout<android.view.View,android.view.ViewGroup,AndroidMetawidget>, Layout<android.view.View,android.view.ViewGroup,AndroidMetawidget>

Direct Known Subclasses:

TableLayout
```
public class LinearLayout
extends Object
implements AdvancedLayout<android.view.View,android.view.ViewGroup,AndroidMetawidget>
```
Layout to arrange widgets vertically, with one row for the label and the next for the widget.

Author:

Richard Kennard

Constructor Summary

Constructors
Constructor and Description

LinearLayout()

LinearLayout(LinearLayoutConfig config)

Constructors
Constructor and Description
`LinearLayout()`
`LinearLayout(LinearLayoutConfig config)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`endContainerLayout(android.view.ViewGroup container, AndroidMetawidget metawidget)` Finish the given container, using the given Metawidget to access additional services if needed (such as state saving).
`protected android.view.ViewGroup`	`getLayout(android.view.ViewGroup container)`
`void`	`layoutWidget(android.view.View view, String elementName, Map<String,String> attributes, android.view.ViewGroup container, AndroidMetawidget metawidget)` Layout the given widget within the given container, using the given elementName and attributes as a guide and the given Metawidget to access additional services if needed (such as state saving)
`protected void`	`layoutWidget(android.view.View view, android.view.ViewGroup viewToAddTo, android.view.ViewGroup container, boolean hasLabel)`
`protected android.view.ViewGroup`	`newViewToAddTo(android.view.ViewGroup metawidget)`
`void`	`onEndBuild(AndroidMetawidget metawidget)` Event called at the end of widget building, after all widgets have been built and added to the `Layout`.
`void`	`onStartBuild(AndroidMetawidget metawidget)` Event called at the start of the widget building process, before the `WidgetBuilder` is called.
`void`	`startContainerLayout(android.view.ViewGroup container, AndroidMetawidget metawidget)` Initialise the given container, using the given Metawidget to access additional services if needed (such as state saving).

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - LinearLayout
```
public LinearLayout()
```
  - LinearLayout
```
public LinearLayout(LinearLayoutConfig config)
```
- Method Detail
  - onStartBuild
```
public void onStartBuild(AndroidMetawidget metawidget)
```
    Description copied from interface: AdvancedLayout
    
    Event called at the start of the widget building process, before the WidgetBuilder is called. Layouts may wish to act on this event to initialize themselves ready for processing, or to perform 'outermost-container-only' processing, such as adding facets. This event is only called once per inspection, not once per widget built.
    
    Specified by:
    
    onStartBuild in interface AdvancedLayout<android.view.View,android.view.ViewGroup,AndroidMetawidget>
    
    Parameters:
    metawidget - the parent Metawidget. Never null
  - startContainerLayout
```
public void startContainerLayout(android.view.ViewGroup container,
                        AndroidMetawidget metawidget)
```
    Description copied from interface: AdvancedLayout
    
    Initialise the given container, using the given Metawidget to access additional services if needed (such as state saving).
    
    Specified by:
    
    startContainerLayout in interface AdvancedLayout<android.view.View,android.view.ViewGroup,AndroidMetawidget>
    
    Parameters:
    container - the container to layout. This is often the same as the given Metawidget
    metawidget - the parent Metawidget. Never null
  - layoutWidget
```
public void layoutWidget(android.view.View view,
                String elementName,
                Map<String,String> attributes,
                android.view.ViewGroup container,
                AndroidMetawidget metawidget)
```
    Description copied from interface: Layout
    
    Layout the given widget within the given container, using the given elementName and attributes as a guide and the given Metawidget to access additional services if needed (such as state saving)
    layoutWidget is called immediately after WidgetBuilder.buildWidget and WidgetProcessor.processWidget, and before the next widget is generated. An alternate design would be to 'collect' all widgets generated by buildWidget and processWidget, then iterate over them separately for the layout. If you prefer this approach, you can simulate it by having layoutWidget do nothing but 'remember' each widget, then iterate over them in endContainerLayout (see the AdvancedLayout interface). However not all UI frameworks allow this approach, because they do not suport widgets being instantiated independent of a layout, nor moved between layouts (e.g. SWT)
    
    Specified by:
    
    layoutWidget in interface Layout<android.view.View,android.view.ViewGroup,AndroidMetawidget>
    
    Parameters:
    view - the widget to layout. Never null
    elementName - XML node name of the business field. Typically 'entity', 'property' or 'action'. Never null
    attributes - attributes of the widget to layout. Never null. This Map is modifiable - changes will be passed to subsequent WidgetProcessors and Layouts
    container - the container to add to. This is often the same as the given Metawidget
    metawidget - the Metawidget to use to access additional services. Never null
  - endContainerLayout
```
public void endContainerLayout(android.view.ViewGroup container,
                      AndroidMetawidget metawidget)
```
    Description copied from interface: AdvancedLayout
    
    Finish the given container, using the given Metawidget to access additional services if needed (such as state saving).
    
    Specified by:
    
    endContainerLayout in interface AdvancedLayout<android.view.View,android.view.ViewGroup,AndroidMetawidget>
    
    Parameters:
    container - the container to layout. This is often the same as the given Metawidget
    metawidget - the Metawidget to use to access additional services. Never null
  - onEndBuild
```
public void onEndBuild(AndroidMetawidget metawidget)
```
    Description copied from interface: AdvancedLayout
    
    Event called at the end of widget building, after all widgets have been built and added to the Layout. Layouts may wish to act on this event to clean themselves up after processing, or to perform 'outermost-container-only' processing, such as adding facets. This event is only called once per inspection, not once per widget built.
    
    Specified by:
    
    onEndBuild in interface AdvancedLayout<android.view.View,android.view.ViewGroup,AndroidMetawidget>
    
    Parameters:
    metawidget - the parent Metawidget. Never null
  - layoutWidget
```
protected void layoutWidget(android.view.View view,
                android.view.ViewGroup viewToAddTo,
                android.view.ViewGroup container,
                boolean hasLabel)
```
    Parameters:
    viewToAddTo - the view to add to. This may be different from container. For example it may be a TableRow
    hasLabel - whether the view has a label. This may affect how it is laid out. For example a TableRow may need to span two columns
  - newViewToAddTo
```
protected android.view.ViewGroup newViewToAddTo(android.view.ViewGroup metawidget)
```
  - getLayout
```
protected android.view.ViewGroup getLayout(android.view.ViewGroup container)
```

Class LinearLayout

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LinearLayout

LinearLayout

Method Detail

onStartBuild

startContainerLayout

layoutWidget

endContainerLayout

onEndBuild

layoutWidget

newViewToAddTo

getLayout