picture

This widget represents a picture.


Attributes
Attribute Default Object Set Get Description
class - No Yes No The widget's style class. The value is as string text.
dataprovider null Yes No Yes The associated dataProvider.
focusedwidget - Yes No Yes Give the focused widget which is a child of the same focusManager that this widget instance. This attribute is read only and could be use in action metod definition.
frameduration - No Yes No Define the animation frame duration. Each frame have the same duration. By default the frame duration is the Kuix frame duration.
frameheight - No Yes No Define the animation frame height. The frames must be equally sized, with the dimensions specified by frameWidth and frameHeight. They may be laid out in the image horizontally, vertically, or as a grid. The width of the source image must be an integer multiple of the frame width, and the height of the source image must be an integer multiple of the frame height. The default value is the image height.
framesequence - No Yes No Picture have a default sequence that displays the frames in order. This attribute allows for the creation of an arbitrary sequence using the available frames. The value is an integer array like : 1,2,1,3.
framewidth - No Yes No Define the animation frame width. The frames must be equally sized, with the dimensions specified by frameWidth and frameHeight. They may be laid out in the image horizontally, vertically, or as a grid. The width of the source image must be an integer multiple of the frame width, and the height of the source image must be an integer multiple of the frame height. The default value is the image width.
id - No Yes Yes The widget's unique identifier. The value is as string text.
image - Yes Yes Yes Define the image data source. The data are a javax.microedition.lcdui.Image instance, like png, gif or jpeg.
Implementations are required to support images stored in the PNG format. This attribute is not compatible with src attribute.
pressedshortcuts - No Yes No see shortcuts.
releasedshortcuts - No Yes No The widget key released shortcuts.
repeatedshortcuts - No Yes No The widget key repeated shortcuts.
shortcuts - No Yes No The widget key pressed shortcuts. The value is a string representing one or more KuixKeyCode ( 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, #, softleft, softright, up, left, right, down, fire, delete, back, pencil ). The multiple keys separator is the '|'.
src - No Yes No Define the image source file path. By default if the path is relative (do not start by '/'), the path is relative to '/img/'. This attribute is not compatible with image attribute. The value could be :
  • <img>
  • <img>,<x>,<y>,<width>,<height>
  • <img>,<x>,<y>,<width>,<height>,<transform>
.
style - No Yes No The author style. The value is as string text where each style property/value couple is separated by a ';' and is conforme to style properties syntax. ( ex: color:red;layout:borderlayout ).
transform - No Yes No Define the transform applied on each picture frames. The value is a transform string : mirror, mirror_rot270, mirror_rot180, mirror_rot90, rot270, rot180, rot90.
visible true No Yes No The widget visibility. The value is a string boolean ( true or false ).


Style properties
Property Default Inherit Description
align center No Define the content alignment. The value is an alignement string ( top, top-left, left, bottom-left, bottom, bottom-right, right, top-right, center, fill, fill-top, fill-left, fill-bottom, fill-right, fill-center ).
bg-align top-left No Define the background images alignment. The value is a list of alignment like align property separated by a '|'. This property is only used if bg-image is defined.
bg-color - No Define the background color. The value is a color like color property.
bg-image - No Define the background images. The value is a liste of image files path separated by a '|'.
bg-repeat 0 0 No Define the background images repeat method. The value is a list of <repeatx> <repeaty> separated by a '|'. 0 means infinit. This property is only used if bg-image is defined.
border 0 0 0 0 No Define the border size. Syntax : <top> <right> <bottom> <left>. If all the values are the same, you can specify only one value.
border-align - No Define the border images alignment. Syntax : <align top> <align top-right> <align right> <align bottom-right> <align bottom> <align bottom-left> <align left> <align top-left>. This property is only used if border-images is defined.
border-color - No Define the border color. The value is an array of 4 colors values (like color property). Syntax : <top> <right> <bottom> <left>. If all the values are the same, you can specify only one value.
border-image - No Define the border image.
Syntax : url(<img>)
or url(<img>) top right bottom left
or url(<top>) url(<top-right>) url(<right>) url(<bottom-right>) url(<bottom>) url(<bottom-left>) url(<left>) url(<top-left>).
border-stroke - No Define the border stroke. The value is dotted or solid.
color #000000 Yes Define the font color. The value is a color string ( red, green, blue, white, black or #rrggbb ).
gap 0 0 No Define the gap. The gap represents the space in pixels between widget of a same parant. It could depends of the parent's layout. Syntax : <hgap> <vgap>.
greyed-color none No Define greyed color used when the widget is added as a popup to the desktop to greyed it. By default this color is null.
layout null No Uneditable.
layout-data null No Define the widget layout data. The value is a layout data tag ( bld(<align>), sld(<align>,<width>,<height>) ).
margin 0 0 0 0 No Define the margin. The margin is the outside border space. Syntax : <top> <right> <bottom> <left>. If all the values are the same, you can specify only one value.
min-size 0 0 No Define the widget min size. Syntax : <minwidth> <minheight>.
padding 0 0 0 0 No Define the padding. The padding is the inside border space. Syntax : <top> <right> <bottom> <left>. If all the values are the same, you can specify only one value.
span 1 1 No Define the col and row span. Span is used only if the parent's widget is a TableLayout. Syntax : <colspan> <rowspan>.
weight 0 0 No Define the weight x and y. Weight is used only if the parent's widget is a TableLayout. Syntax : <weightx> <weighty>.


Pseudo Classes
Name Description


Available internal widgets
Internal widget Description


Copyright © 2007-2008 Kalmeo. All Rights Reserved.