property LPicture.Name as Variant
Indicates the picture to be shown on the layer's background.

TypeDescription
Variant

The Name property could be one of the following:

  • A String expression indicates:
    • a name of a picture file in the PicturePath folder. For instance, Name = "Layer1.png", loads the Layer1.png file if found in the PicturePath folder.
    • a picture file including its absolute path. For instance, Name = "C:\Program Files\Exontrol\ExGauge\Sample\Design\Circular\Knob\Layer1.png", loads the Layer1.png file from absolute path
    • a key of the HTML picture, previously loaded by the HTMLPicture method. For instance, Name = "pic1", loads the HTML picture with the key pic1, so the pic1 should be load previously with a HTMLPicture call like HTMLPicture("pic1") = "C:\Program Files\Exontrol\ExGauge\Sample\Design\Circular\Knob\Layer1.png"
    • an encode BASE64 string of a picture file. The Exontrol's ExImages Tool encode/decode BASE64 strings from/to pictures. In this case, the string starts with "gB..", "gC.." and so on.
  • A Picture object that indicates the picture to be displayed. For instance, Name = LoadPicture("picture.jpg")

By default, the Name / Value property is initialized by evaluating the control's PicturesName property, whose value keyword is replaced by the Index of the current layer. The Name / Value property are equivalents, so use any of them do the same. 

The control supports almost all type of pictures like

If using the PNG format, the control handles automatically its transparency / alpha blending, unless the Opaque property is True.  For any other picture type, you can use any of the following to define the transparent region of the picture:

The picture is displayed on the layer's background if both of the following:

are accomplished.

The following properties can be used to load / import ( manually or automatically ) pictures to the layer's background:

The PicturesPathPicturesName properties can be used to automatically loads files from a specified folder to be displayed on the layer's background.  

For instance, 

PicturesPath = "C:\Program Files\Exontrol\ExGauge\Sample\Design\Circular\Knob", defines default folder to load pictures from.
PicturesName = "`Layer` + str(value + 1) + `.png`", defines the name of the picture file to be loaded by the layer with the index / value. It defines the names as: Layer1.png for the layer with the index 0, Layer2.png for the layer with the index 1, Layer3.png for the layer with the index 2, and so on.

The Picture.Name / Picture.Value property of the Picture object loads a picture / graphics to be displayed on the layer's background. 

The following properties can be used to move / resize the picture on the layer's background: