Panel.Text Property (ExStatusBar)

Use the Text property to assign an HTML caption to a panel. Use the Format property to add and arrange panels in your status bar control. Use the Panel property to access a Panel object. Use the Debug property to display the identifiers of the panels in the status bar. Use the Enabled property to enable or disable a panel. Use the ToolTipText property to specify the tooltip being shown when the cursor hovers the panel. Use the Image property to assign a single icon to a panel, or use the <img> HTML tag to assign multiple icons or custom size pictures to a panel. Use the Images method to assign a list of icons to your status bar. Use the Percent property to display a progress bar inside the panel. Use the Transparency property to apply semi-transparent color or use the ForeColor property to specify the panel's foreground color. Use the ControlID property to display an ActiveX control inside the panel.

Use the Offset property to apply extra padding to your text inside the panel.

The Text property supports the following HTML tags:

 ...  displays the text in bold
 ...  displays the text in italics
 ...  underlines the text
<s> ... </s> ~~Strike~~-through text
<a id;options> ... </a> displays an anchor element that can be clicked. An anchor is a piece of text or some other object (for example an image) which marks the beginning and/or the end of a hypertext link.The <a> element is used to mark that piece of text (or inline image), and to give its hypertextual relationship to other documents. The control fires the AnchorClick(AnchorID, Options) event when the user clicks the anchor element. The FormatAnchor property customizes the visual effect for anchor elements.
 ...  displays portions of text with a different font and/or different size. For instance, the bit draws the bit text using the Tahoma font, on size 12 pt. If the name of the font is missing, and instead size is present, the current font is used with a different size. For instance, bit displays the bit text using the current font, but with a different size.
<fgcolor rrggbb> ... </fgcolor> or <fgcolor=rrggbb> ... </fgcolor> displays text with a specified foreground color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<bgcolor rrggbb> ... </bgcolor> or <bgcolor=rrggbb> ... </bgcolor> displays text with a specified background color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<solidline rrggbb> ... </solidline> or <solidline=rrggbb> ... </solidline> draws a solid-line on the bottom side of the current text-line, of specified RGB color. The <solidline> ... </solidline> draws a black solid-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<dotline rrggbb> ... </dotline> or <dotline=rrggbb> ... </dotline> draws a dot-line on the bottom side of the current text-line, of specified RGB color. The <dotline> ... </dotline> draws a black dot-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<upline> ... </upline> draws the line on the top side of the current text-line (requires <solidline> or <dotline>).
<r> right aligns the text
<c> centers the text
  forces a line-break
<img>number[:width]</img> inserts an icon inside the text. The number indicates the index of the icon being inserted. Use the Images method to assign a list of icons to your chart. The last 7 bits in the high significant byte of the number expression indicates the identifier of the skin being used to paint the object. Use the Add method to add new skins to the control. If you need to remove the skin appearance from a part of the control you need to reset the last 7 bits in the high significant byte of the color being applied to the part. 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.
<img>key[:width]</img> inserts a custom size picture into the text being previously 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.
& glyph characters as & ( & ), < ( < ), > ( > ), &qout; ( " ) and &#number; ( the character with specified code ), For instance, the € displays the EUR character. The & ampersand is only recognized as markup when it is followed by a known letter or a #character and a digit. For instance if you want to display bold in HTML caption you can use bold
<off offset> ... </off> defines the vertical offset to display the text/element. The offset parameter defines the offset to display the element. This tag is inheritable, so the offset is keep while the associated </off> tag is found. You can use the <off offset> HTML tag in combination with the to define a smaller or a larger font to be displayed. For instance: Text with <off 6>subscript displays the text such as: Text with _subscriptThe Text with <off -6>superscript displays the text such as: Text with ^subscript
<gra rrggbb;mode;blend> ... </gra> defines a gradient text. The text color or <fgcolor> defines the starting gradient color, while the rr/gg/bb represents the red/green/blue values of the ending color, 808080 if missing as gray. The mode is a value between 0 and 4, 1 if missing, and blend could be 0 or 1, 0 if missing. The HTML tag can be used to define the height of the font. Any of the rrggbb, mode or blend field may not be specified. The <gra> with no fields, shows a vertical gradient color from the current text color to gray (808080). For instance the <gra FFFFFF;1;1>gradient-center</gra> generates the following picture:
<out rrggbb;width> ... </out> shows the text with outlined characters, where rr/gg/bb represents the red/green/blue values of the outline color, 808080 if missing as gray, width indicates the size of the outline, 1 if missing. The text color or <fgcolor> defines the color to show the inside text. The HTML tag can be used to define the height of the font. For instance the <out 000000><fgcolor=FFFFFF>outlined</fgcolor></out> generates the following picture:
<sha rrggbb;width;offset> ... </sha> define a text with a shadow, where rr/gg/bb represents the red/green/blue values of the shadow color, 808080 if missing as gray, width indicates the size of shadow, 4 if missing, and offset indicates the offset from the origin to display the text's shadow, 2 if missing. The text color or <fgcolor> defines the color to show the inside text. The HTML tag can be used to define the height of the font. For instance the <sha>shadow</sha> generates the following picture:
or <sha 404040;5;0><fgcolor=FFFFFF>outline anti-aliasing</fgcolor></sha> gets:

The following VB sample shows "How do I assign a caption or a text to a panel":

With StatusBar1
	.BeginUpdate 
	.VisualAppearance.Add 4,"c:\exontrol\images\border.ebn"
	.VisualAppearance.Add 5,"CP:4 1 1 -1 -1"
	.BackColorPanels = 83886080
	.BackColor = -2147483633
	.Format = "1/2"
	.Panel(1).Text = "Panel 1"
	.Panel(2).Text = "Panel 2"
	.EndUpdate 
End With

The following VB.NET sample shows "How do I assign a caption or a text to a panel":

With AxStatusBar1
	.BeginUpdate 
	.VisualAppearance.Add 4,"c:\exontrol\images\border.ebn"
	.VisualAppearance.Add 5,"CP:4 1 1 -1 -1"
	.GetOcx().BackColorPanels = &H5000000
	.GetOcx().BackColor = &H8000000f
	.Format = "1/2"
	.get_Panel(1).Text = "Panel 1"
	.get_Panel(2).Text = "Panel 2"
	.EndUpdate 
End With

The following C++ sample shows "How do I assign a caption or a text to a panel":

/*
	Copy and paste the following directives to your header file as
	it defines the namespace 'EXSTATUSBARLib' for the library: 'ExStatusBar 1.0 Control Library'

	#import "C:\\WINNT\\system32\\ExStatusBar.dll"
	using namespace EXSTATUSBARLib;
*/
EXSTATUSBARLib::IStatusBarPtr spStatusBar1 = GetDlgItem(IDC_STATUSBAR1)->GetControlUnknown();
spStatusBar1->BeginUpdate();
spStatusBar1->GetVisualAppearance()->Add(4,"c:\\exontrol\\images\\border.ebn");
spStatusBar1->GetVisualAppearance()->Add(5,"CP:4 1 1 -1 -1");
spStatusBar1->PutBackColorPanels(83886080);
spStatusBar1->PutBackColor(-2147483633);
spStatusBar1->PutFormat(L"1/2");
spStatusBar1->GetPanel(long(1))->PutText(L"Panel 1");
spStatusBar1->GetPanel(long(2))->PutText(L"Panel 2");
spStatusBar1->EndUpdate();

The following C# sample shows "How do I assign a caption or a text to a panel":

axStatusBar1.BeginUpdate();
axStatusBar1.VisualAppearance.Add(4,"c:\\exontrol\\images\\border.ebn");
axStatusBar1.VisualAppearance.Add(5,"CP:4 1 1 -1 -1");
(axStatusBar1.GetOcx() as EXSTATUSBARLib.StatusBar).BackColorPanels = 0x5000000;
(axStatusBar1.GetOcx() as EXSTATUSBARLib.StatusBar).BackColor = 0x8000000f;
axStatusBar1.Format = "1/2";
axStatusBar1.get_Panel(1).Text = "Panel 1";
axStatusBar1.get_Panel(2).Text = "Panel 2";
axStatusBar1.EndUpdate();

The following VFP sample shows "How do I assign a caption or a text to a panel":

with thisform.StatusBar1
	.BeginUpdate
	.VisualAppearance.Add(4,"c:\exontrol\images\border.ebn")
	.VisualAppearance.Add(5,"CP:4 1 1 -1 -1")
	.BackColorPanels = 83886080
	.BackColor = -2147483633
	.Format = "1/2"
	.Panel(1).Text = "Panel 1"
	.Panel(2).Text = "Panel 2"
	.EndUpdate
endwith

		Type	Description
		String	A String expression that indicates the caption of the panel. This property supports HTML format as listed bellow.