BackgroundImageName Property (HtmlBoxTextWindow)

Gets or sets a value specifying the image name to display within the editing window.

Syntax

Visual Basic

'Declaration
 
Public Property BackgroundImageName As String

C#

public string BackgroundImageName {get; set;}

Property Value

A string containing no instances of "/", "\", or "~" indicating a image file contained within WebHtmlEditor.ImageDirectory or a string containing one or many instances of "/", "\", or "~" indicating a full virtual, relative, or absolute path to an image file. The default value is an empty string.

Remarks

When this property is set, an image is displayed on the background of the editing surface. This image does not interfere with editing. Typing occurs "over" the image. This is a useful property to use if you would like to set a watermark for the editor.

WebHtmlEditor automatically assumes that all images are in the directory specified by WebHtmlEditor.ImageDirectory. For example, if the value of WebHtmlEditor.ImageDirectory is "/ig_common/images/htmleditor/" (the default) and this property was set to "myimage.jpg", the control would assume the file can be found at "/ig_common/images/htmleditor/myimage.jpg". If you set this property to a string that has some form of directory designation, such as "slashes" within it (for example "C:\temp\myimage.jpg") the control would no longer assume that the image is within WebHtmlEditor.ImageDirectory but would use the full path you supplied for this property.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2