Item.Image Property (ExListBar)

By default, the Image property is 0. The images list collection is 1 based. Use the Image property to assign an icon or a picture to an item. Use the Image parameter of the AddItem method to assign an image at adding time. Use the ReplaceIcon and Images method to change the icons list collection at runtime. Use the <img> HTML tag to insert icons inside the iteml's caption, if the CaptionFormat property is exHTML. At design time, the control displays an icons list window ( if the ShowImageList property is true ) where icons or resource files can be dropped.

The following VB sample loads a collection of icons from a BASE64 encoded string:

With ListBar1
    Dim s As String
    s = "gBJJgBAIEAAGAEGCAAhb/hz/EIAh8Tf5CJo2AEZjQAjEZFEaIEaEEaAIAkcbk0olUrlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/wGBvqAQEZwmCpmEwrAxlVh9dxjAiUOyb/AGHp2YjWPx9kx+KAGR0ON0VIzmU0+WluUomY1OV0eS0Wa1uF0Gd1G51VX1+g0Wzw++xuO3dG0WP3+k5WS2+U2k65uqyml3UZ6tM1+f4PbxeN7Xd2XDmedjfT8Wb4uw3GW8ky13V5HL2OXw/Z52F9229+wyf0/TCvs9jWJ/AL/Pm+LJQRAzkskmj2v48r0tA6L1QGmTjvM8MNPnCkCwYlrQP7BUQurCb9wLBz4Pu8DYQwy0XQ47iYtelEBvw9EBRzA0RQtED8Q8+TgQA6sPw+lkKR46TLRNIcdOFBsephAsntgzDMRhGEaJfLTrRW/kVSc+sopXLEgvlDswPm0sttZEsZSTA0SR0nDesPMrmPxK75RRNkdQfOUKznNMQvHIkzTxJsWvOnTr0bJcZPW+b+zpL0izPPNMS7P0xpdPixTrRNQTU+Sa0dL8wv/Lqg0tDcPytH7ro059SzTAsHqpUVbQynNI17Ns5qPVlRzww0bpXV6fV09KuO/QKWzXAlBWAqVhOBYtrvpbFZp5Liy27BTTV+yF"
    s = s + "FphZDEJtT1zp7bd1XasiLB8ld4o8kCRJIACSpRfNKWXd1uH+eaHn8P55necB/kmf5+A+eBnnAH5AH+fADnAB5gAeQAfngAJwACYABkAB5wNCAL8AG2WSozlJAX2AbDJKkoD3xfGWABmWXY8koHgBkGGNDiwE4efwAHhnx8B+y2Fn4HOBn+YJ/6QPaHnGiaAg="
    .BeginUpdate
    .Images s
    With .Groups
        With .Add("Group 1")
            .AddItem "Item 1", 1
            .AddItem "Item 2", 2
        End With
        With .Add("Group 2")
            .AddItem "Item 1", 2
            .AddItem "Item 2", 1
        End With
    End With
    .EndUpdate
End With

The following C++ sample loads a collection of icons from a BASE64 encoded string:

#include "Item.h"
#include "Group.h"
#include "Groups.h"
COleVariant vtMissing; V_VT( &vtMissing ) = VT_ERROR;
CString s("gBJJgBAIEAAGAEGCAAhb/hz/EIAh8Tf5CJo2AEZjQAjEZFEaIEaEEaAIAkcbk0olUrlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/wGBvqAQEZwmCpmEwrAxlVh9dxjAiUOyb/AGHp2YjWPx9kx+KAGR0ON0VIzmU0+WluUomY1OV0eS0Wa1uF0Gd1G51VX1+g0Wzw++xuO3dG0WP3+k5WS2+U2k65uqyml3UZ6tM1+f4PbxeN7Xd2XDmedjfT8Wb4uw3GW8ky13V5HL2OXw/Z52F9229+wyf0/TCvs9jWJ/AL/Pm+LJQRAzkskmj2v48r0tA6L1QGmTjvM8MNPnCkCwYlrQP7BUQurCb9wLBz4Pu8DYQwy0XQ47iYtelEBvw9EBRzA0RQtED8Q8+TgQA6sPw+lkKR46TLRNIcdOFBsephAsntgzDMRhGEaJfLTrRW/kVSc+sopXLEgvlDswPm0sttZEsZSTA0SR0nDesPMrmPxK75RRNkdQfOUKznNMQvHIkzTxJsWvOnTr0bJcZPW+b+zpL0izPPNMS7P0xpdPixTrRNQTU+Sa0dL8wv/Lqg0tDcPytH7ro059SzTAsHqpUVbQynNI17Ns5qPVlRzww0bpXV6fV09KuO/QKWzXAlBWAqVhOBYtrvpbFZp5Liy27BTTV+yF");
s = s + "FphZDEJtT1zp7bd1XasiLB8ld4o8kCRJIACSpRfNKWXd1uH+eaHn8P55necB/kmf5+A+eBnnAH5AH+fADnAB5gAeQAfngAJwACYABkAB5wNCAL8AG2WSozlJAX2AbDJKkoD3xfGWABmWXY8koHgBkGGNDiwE4efwAHhnx8B+y2Fn4HOBn+YJ/6QPaHnGiaAg=";
m_listbar.BeginUpdate();
CGroups groups = m_listbar.GetGroups();
m_listbar.Images(COleVariant(s));
CGroup group1 = groups.Add( "Group 1" );
group1.AddItem( "Item 1", COleVariant(long(1)) );
group1.AddItem( "Item 2", COleVariant(long(2)) );
CGroup group2 = groups.Add( "Group 2" );
group2.AddItem( "Item 1", COleVariant(long(3)) );
group2.AddItem( "Item 2", COleVariant(long(4)) );
m_listbar.EndUpdate();

The following VB.NET sample loads a collection of icons from a BASE64 encoded string:

With AxListBar1
    Dim s As String = "gBJJgBAIEAAGAEGCAAhb/hz/EIAh8Tf5CJo2AEZjQAjEZFEaIEaEEaAIAkcbk0olUrlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/wGBvqAQEZwmCpmEwrAxlVh9dxjAiUOyb/AGHp2YjWPx9kx+KAGR0ON0VIzmU0+WluUomY1OV0eS0Wa1uF0Gd1G51VX1+g0Wzw++xuO3dG0WP3+k5WS2+U2k65uqyml3UZ6tM1+f4PbxeN7Xd2XDmedjfT8Wb4uw3GW8ky13V5HL2OXw/Z52F9229+wyf0/TCvs9jWJ/AL/Pm+LJQRAzkskmj2v48r0tA6L1QGmTjvM8MNPnCkCwYlrQP7BUQurCb9wLBz4Pu8DYQwy0XQ47iYtelEBvw9EBRzA0RQtED8Q8+TgQA6sPw+lkKR46TLRNIcdOFBsephAsntgzDMRhGEaJfLTrRW/kVSc+sopXLEgvlDswPm0sttZEsZSTA0SR0nDesPMrmPxK75RRNkdQfOUKznNMQvHIkzTxJsWvOnTr0bJcZPW+b+zpL0izPPNMS7P0xpdPixTrRNQTU+Sa0dL8wv/Lqg0tDcPytH7ro059SzTAsHqpUVbQynNI17Ns5qPVlRzww0bpXV6fV09KuO/QKWzXAlBWAqVhOBYtrvpbFZp5Liy27BTTV+yF"
    s = s + "FphZDEJtT1zp7bd1XasiLB8ld4o8kCRJIACSpRfNKWXd1uH+eaHn8P55necB/kmf5+A+eBnnAH5AH+fADnAB5gAeQAfngAJwACYABkAB5wNCAL8AG2WSozlJAX2AbDJKkoD3xfGWABmWXY8koHgBkGGNDiwE4efwAHhnx8B+y2Fn4HOBn+YJ/6QPaHnGiaAg="
    .BeginUpdate()
    .Images(s)
    With .Groups
        With .Add("Group 1")
            .AddItem("Item 1", 1)
            .AddItem("Item 2", 2)
        End With
        With .Add("Group 2")
            .AddItem("Item 1", 3)
            .AddItem("Item 2", 4)
        End With
    End With
    .EndUpdate()
End With

The following C# sample loads a collection of icons from a BASE64 encoded string:

String s= "gBJJgBAIEAAGAEGCAAhb/hz/EIAh8Tf5CJo2AEZjQAjEZFEaIEaEEaAIAkcbk0olUrlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/wGBvqAQEZwmCpmEwrAxlVh9dxjAiUOyb/AGHp2YjWPx9kx+KAGR0ON0VIzmU0+WluUomY1OV0eS0Wa1uF0Gd1G51VX1+g0Wzw++xuO3dG0WP3+k5WS2+U2k65uqyml3UZ6tM1+f4PbxeN7Xd2XDmedjfT8Wb4uw3GW8ky13V5HL2OXw/Z52F9229+wyf0/TCvs9jWJ/AL/Pm+LJQRAzkskmj2v48r0tA6L1QGmTjvM8MNPnCkCwYlrQP7BUQurCb9wLBz4Pu8DYQwy0XQ47iYtelEBvw9EBRzA0RQtED8Q8+TgQA6sPw+lkKR46TLRNIcdOFBsephAsntgzDMRhGEaJfLTrRW/kVSc+sopXLEgvlDswPm0sttZEsZSTA0SR0nDesPMrmPxK75RRNkdQfOUKznNMQvHIkzTxJsWvOnTr0bJcZPW+b+zpL0izPPNMS7P0xpdPixTrRNQTU+Sa0dL8wv/Lqg0tDcPytH7ro059SzTAsHqpUVbQynNI17Ns5qPVlRzww0bpXV6fV09KuO/QKWzXAlBWAqVhOBYtrvpbFZp5Liy27BTTV+yF";
s = s + "FphZDEJtT1zp7bd1XasiLB8ld4o8kCRJIACSpRfNKWXd1uH+eaHn8P55necB/kmf5+A+eBnnAH5AH+fADnAB5gAeQAfngAJwACYABkAB5wNCAL8AG2WSozlJAX2AbDJKkoD3xfGWABmWXY8koHgBkGGNDiwE4efwAHhnx8B+y2Fn4HOBn+YJ/6QPaHnGiaAg=";
axListBar1.BeginUpdate();
axListBar1.Images(s);
EXLISTBARLib.Group group1 = axListBar1.Groups.Add("Group 1");
group1.AddItem("Item 1", 1);
group1.AddItem("Item 2", 2);
EXLISTBARLib.Group group2 = axListBar1.Groups.Add("Group 2");
group2.AddItem("Item 1", 3);
group2.AddItem("Item 2", 4);
axListBar1.EndUpdate();

The following VFP sample loads a collection of icons from a BASE64 encoded string:

With thisform.ListBar1
	local s
    .BeginUpdate()
   	s = "gBJJgBAIEAAJAEGCAAhb/hz/EIAh8Tf5CJo2AEZjQAjEZFEaIEaGEaAIAEEbjMjlErlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/wGBwWDwm"
	s = s + "Fw2HxGJxWLxmNx2PyGRyWTymVy2XzGZzWbzmdz2f0Gh0Wj0ml02npqAQEZ1WojWq1bA2VWh9e2TAiUO3L/AGtp++jW12tl2uwAG34+z5FJ4W65u8l26ou+5+75O45HA6er43D53f6FY6vG5HZ1vk2e08NH5G18vK+G47u67U7+fQ3XL8EZ/dN6rivPALYtnAEBuw9KaO"
	s = s + "Gjb8wQ4L1us7zeQUmbqP29z4uu3rWv++jVwo7kKus3MNRA1cOQk6SgRPEkMwu3EXRY97cJrCcRQXB7jPvCEUpm9sGQPIEMx1FcZJc40RxhI79xzEMVxpC0OwM60fN5KkhQEmTqpRFMPQdFEvxZJEeSND0iQw80TP3IsipbHUxPw3kmTTMD0RnMaYxXOrrN830rStLSYU"
	s = s + "A/koxFKE6Q3O6WT9M8MSHQ0MuXQLpSXLE3xZJUwJy8bW0W+UPT7DEnUlMEa0xHdM0fI8EzVRlPTnKcGp2/tZzjLEIwzEdNUJNdG0/X1B1JRKX1EsdN1fY1IQwm1aULQ8S0GoVeSDIs+TK/rXy6nEV23YSpWRbkq1jJ84WbcsaqLaVk081lspXaqf3AsUC1Ol1IxVVFMq"
	s = s + "pdLzXZfsNX8+qfUEs2Bxg5lJwerN7Jld7LWIz2Atc0qLB8lmKo8kCRJIACSo2QGO11hOJM2hx5oefw/nmd5wH+SZ/n4D54GecAfkAf58AOcAHmAB5AB+eAAnAAJgAGQAHnA44Aw8AbsaUjOnY+jQBtYkqSgPjmOajq+p6GkoHgBouYuPnYE5ofwAHhsR8B+3mYH4HOUH"
	s = s + "+YJ/7YPaHnGiaAg="
    With .Groups
        With .Add("Group 1")
            .AddItem("Item 1",1)
            .AddItem("Item 2",2)
        EndWith
        With .Add("Group 2")
            .AddItem("Item 1",3)
            .AddItem("Item 2",4)
        EndWith
    EndWith
    .EndUpdate()
EndWith

The following Template sample loads a collection of icons from a BASE64 encoded string:

BeginUpdate
Images("gBJJgBAIEAAJAEGCAAhb/hz/EIAh8Tf5CJo2AEZjQAjEZFEaIEaGEaAIAEEbjMjlErlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/wGBwWDwmFw2HxGJxWLxmNx2PyGRyWTymVy2XzGZzWbzmdz2f0Gh0Wj0ml02npqAQEZ1WojWq1bA2VWh9e2TAiUO3L/AGtp++jW12tl2uwAG34+z5FJ4W65u8l26ou+5+75O45HA6er43D53f6FY6vG5HZ1vk2e08NH5G18vK+G47u67U7+fQ3XL8EZ/dN6rivPALYtnAEBuw9KaOGjb8wQ4L1us7zeQUmbqP29z4uu3rWv++jVwo7kKus3MNRA1cOQk6SgRPEkMwu3EXRY97cJrCcRQXB7jPvCEUpm9sGQPIEMx1FcZJc40RxhI79xzEMVxpC0OwM60fN5KkhQEmTqpRFMPQdFEvxZJEeSND0iQw80TP3IsipbHUxPw3kmTTMD0RnMaYxXOrrN830rStLSYUA/koxFKE6Q3O6WT9M8MSHQ0MuXQLpSXLE3xZJUwJy8bW0W+UPT7DEnUlMEa0xHdM0fI8EzVRlPTnKcGp2/tZzjLEIwzEdNUJNdG0/X1B1JRKX1EsdN1fY1IQwm1aULQ8S0GoVeSDIs+TK/rXy6nEV23YSpWRbkq1jJ84WbcsaqLaVk081lspXaqf3AsUC1Ol1IxVVFMqpdLzXZfsNX8+qfUEs2Bxg5lJwerN7Jld7LWIz2Atc0qLB8lmKo8kCRJIACSo2QGO11hOJM2hx5oefw/nmd5wH+SZ/n4D54GecAfkAf58AOcAHmAB5AB+eAAnAAJgAGQAHnA44Aw8AbsaUjOnY+jQBtYkqSgPjmOajq+p6GkoHgBouYuPnYE5ofwAHhsR8B+3mYH4HOUH+YJ/7YPaHnGiaAg=")
Groups
{
	"Group 1"
	{
		AddItem("Item 1",1)
		AddItem("Item 2",2)
	}
	"Group 2"
	{
		AddItem("Item 1",3)
		AddItem("Item 2",4)
	}
}
EndUpdate

		Type	Description
		Variant	A long expression that indicates the index of icon being used, a string expression that indicates the base64 encoded string that holds a picture object, or a Picture object. Use the eximages tool to save your picture as base64 encoded format.