eXontrol Software - PropertiesList ActiveX, NET Control

By default, the HTMLName property is empty. If the HTMLName property is empty, the Name property is displayed in the name column. Use the HTMLName property to assign pictures, icons or font attributes to parts of the caption being displayed in the Name column. The HTMLName property supports the following built-in HTML tags:

bold bolds a part of the caption.
underline specifies that the portion should appear as underlined.
<s> ~~strikeout~~ </s> specifies that the portion should appear as strikeout.
italic specifies that the portion should appear as italic.
<fgcolor=FF0000> fgcolor </fgcolor> changes the foreground color for a portion.
<bgcolor=FF0000> bgcolor </bgcolor> changes the background color for a portion.
breaks a line.
<solidline> draws a solid line. If has no effect for a single line caption.
<dotline> draws a dotted line. If has no effect for a single line caption.
<upline> draws the line to the top of the text line
<r> aligns the rest of the text line to the right side. It has no effect if the caption contains a single line.
<img>number[:width]</img> inserts an icon inside the cell's caption. The number indicates the index of the icon being inserted. The width is optional and indicates the width of the icon being inserted. Using the width option you can overwrite multiple icons getting a nice effect. By default, if the width field is missing, the width is 18 pixels. Use the Images method to load a collection of icons. Use the ReplaceIcon property to add or replace an icon.
<img>key[:width]</img> inserts a custom size picture being loaded using the HTMLPicture property. The Key parameter indicates the key of the picture being displayed. The Width parameter indicates a custom size, if you require to stretch the picture, else the original size of the picture is used.

For instance, the "Bold" sequence displays a string like follows: Bold. The control displays the HTMLName property instead Name property, only if the HTMLName is not empty. Use the IncludeProperty to assign a new html format for a specified property, like in the following sample.

For instance, the following VB sample adds an icon to the Appearance property.

Private Sub PropertiesList1_IncludeProperty(ByVal Property As EXPROPERTIESLISTLibCtl.IProperty, Cancel As Boolean)
    If Property.Name Like "Appearance" Then
        Property.HTMLName = "<img>1</img>" & Property.Name
    End If
End Sub

For instance, the following template sample adds three properties and assign an icon to each of them, using the <img> tag.

BeginUpdate Images("gBJJgBAIDAAGAAEAAQhYAf8Pf4hh0QihCJo2AEZjQAjEZFEaIEaEEaAIAkcbk0olUrlktl0vmExmUzmk1m03nE5nU7nk9n0/oFBoVDolFo1HpFJpVLplNp1PqFRqVTqlVq1XrFZrVbrldr1fsFhsVjslls1ntFptVrtltt1vuFxuVzul1u13vF5vV7vl9v1/syEQSEADGYbGAGCwj/jWKxuPjOEyOJwcOxuVx2MyOViGAz0szWUwmOx2TjOh1Ea0OjzGt1mL1UPuuZ2Vcw2I29NzOXyWJ1WiwuHieM0uW0fA0O51G1uedzvK5lS3PT4W5qW9xnO2XP4WnyEzztw2nZ2XQxnmpPU3HV9mI7WhnWk13f8nE+fhy2T+WvlH4tz3uC9ztvK4TuQE+CeusjT1QC4cHQAmjxwc0zLM7CT8NXBrcuK07orTC8CQPBsAPQ9CaQUjMUQ1ArZRA+sJpWx0GQo88WRe4sMwZDkYLVEkbQdEzfMnA0eJjHcVPRAD9wfDyNwklzsN+70pyElcNsqjb/LLJciS65jCSCxcmpfK7exS4UZR/F0gO6l81whKrezlEcBxqxEdy0sjUs2/kvQzOExQQmEdSxBcfyU+86yMzkWxi2MEPROcKTK/sxx7KTgQlBU5zyncGUjR8mTsms31DJE1UNEVKSzSy4yXLkQyKokAQs+lFQjRkb1DLUk0bM71zvQsO0EvdXvmqlaVinEJUlUSUVBYcq1XULPpVJauTgm01uxW9UzZO9vWnaNq3I5FFWTSFD3PWM8VbctivnYz+XlTN43tQKyosHyV32jyQJEkgAJKlGBpxTt3p4iiNnmf+GI2cB/4hh4fnAH6NmAB+MYuAZgIMjRAADkCN5BkSNoNjyNZPkYDkAA+HgOcGXI0fAH5ojZ/AfnEsk+f5P1Y6KAg") Add("Icon1","",1).HTMLName = "<img>1</img>Icon 1" Add("Icon2","",1).HTMLName = "<img>2</img>Icon 2" Add("Icon3","",1).HTMLName = "<img>3</img>Icon 3" EndUpdate

The following VB sample adds a picture to a property:

With PropertiesList1
    .HasGridLines = False
    .DefaultItemHeight = 52
    .HTMLPicture("floppy") = "D:\Temp\Icons\3floppy_1mount.gif"
    .HTMLPicture("hard") = "D:\Temp\Icons\3floppy_mount.gif"
    With .Add("Floppy", "", EditColor)
        .HTMLName = "<img>floppy</img>Floppy"
    End With
    With .Add("Hard", "", EditColor)
        .HTMLName = "<img>hard</img>Hard"
    End With
End With

Send comments on this topic.

		Type	Description
		String	A string expression that indicates the HTML format being displayed in the Name column, instead Name property.