GnSignatureEmbedded
- Widget XML tag
<com.ginstr.widgets.GnSignatureEmbedded>
- Description
GnSignatureEmbedded
inherits regular AndroidView
widget.- It does not open new activity for signature entry and it allows a signature to be drawn directly into it on a screen containing other widgets.
- If widget is used to take signature over existing layout this widget needs to be last in xml (top shown) in the hierarchy and stretch over all widgets to "overlay" existing layout and part of
gn:signatureCaptureWidgetId
root node
XML Attributes Description
Attribute | Description |
---|---|
gn:s_overlayText
|
Displays text in the middle of the widget
Can be
|
gn:backgroundColor
|
Can be
|
gn:strokeColor
|
Can be
|
gn:signatureCaptureWidgetId
|
target WIDGET ONLY which represents root node of all that will be displayed in signature
|
gn:controlPaddingWidgetId
|
target WIDGET ONLY which represents a widget which is set at the top of the gn:signatureCaptureWidgetId as child node. The widget will be removed after signature is taken to crop image of excess space that signature taking controls occupy
|
gn:act_setAfterSignatureTaken
|
Event which will be executed after user has taken signature with this widget. |
gn:act_setAfterSignatureNotTaken
|
Event which will be executed after user has canceled or pressed back when taking media with this widget.
More information here |
gn:disableInternalEvents
|
disables internal event which is predefined for embedded signature controls (i.e. cancel or clear). This provides option to call internal events only externally by using this attribute together with action gn:callWidgetEvent.
|
gn:controlLayout *
|
Defines custom layout to parse for widget, by default is used: widget_en_embedded_signature_controls.xml |
Events
Data types
Input |
---|
text
|
signature
|
Output |
---|
signature
|
Example
<com.ginstr.widgets.GnButton android:layout_width="wrap_content" android:layout_height="wrap_content" gn:backgroundChecked="@drawable/fuelRed" gn:backgroundUnchecked="@drawable/fuelBlue" />
Alternative layout
- If the default look and feel needs to be changed, create or copy identical files from $defaultApp to current app "control" folder.
- To provide alternative layout, the files mentioned above can be set into control folder of the current application. Files must be named as shown above and widgets with Id’s have to stay of same type and keep same id.
widget_en_embedded_signature_controls.xml
- widget_en_embedded_signature_controls.xml is added to Controls folder
Widget Name Description LinearLayout
@+id/controlsContainer
this is the container that holds all the controls GnButton
@+id/cancel
Cancels taking signature and returns to previous screen GnButton
@+id/clear
Clears user entered content on signature area GnButton
@+id/getsign
Saves user entered content and signature background and returns to previous screen