HtmlMessageBoxSetNewlineIsBreak

HtmlMessageBoxSetNewlineIsBreak is used to change the behaviour of the MessageBox's interpretation of HTML, by determining whether newline characters (ASCII 10), or carriage returns followed by newlines (ASCII 13 then 10) are treated as link breaks, like the HTML "<BR>". It persists as long as the DLL is loaded, or until another call to the same function is made.

Syntax:

 Standard Windows API Calling:

 void HtmlMessageBoxSetNewlineIsBreak(int newlineIsBreak);

 COM Object Calling:

 obj.SetNewlineIsBreak(LONG newlineIsBreak)

 .NET Object Calling (C# / VB.NET):

 HtmlMsgBox.SetNewlineIsBreak(int newlineIsBreak);

 PowerBuilder Calling:

 obj.HtmlMessageBoxSetNewlineIsBreak(int newlineIsBreak)

Parameters:

newlineIsBreak: If non-0, newlines (or carriage returns followed by newlines) are treated as line breaks. If 0, newlines (or carriage returns followed by newlines) are treated as whitespace (i.e. one space).

Return Value:

None.

Remarks:

When this has been called with a non-0 value, either a newline (ASCII 10) or a carriage return followed by a newline (ASCII 13, then 10) are converted to "<BR>", and thus interpreted as a line break.

Example:

For standard Windows API calling:

HtmlMessageBoxSetNewlineIsBreak(1);