POSITION CBCGPEditCtrl::SetBlockColor	(	CString	strBlockOpen,
		CString	strBlockClose,
		BOOL	bWholeText = FALSE,
		COLORREF	clrFrgnd = (COLORREF)-1,
		COLORREF	clrBkgnd = (COLORREF)-1,
		BOOL	bCaseSensitive = FALSE,
		BOOL	bWholeWord = FALSE
	)

Adds a new color block definition to the list of color block definitions.

Returns

A position of the newly added color block definition in the internal list of color block definitions (m_lstColorBlocks). It can be NULL and the function asserts in the following cases:

• strBlockOpen or strBlockClose length exceeds _MAX_COLOR_BLOCK_STR_LEN (currently set to 4)
• bWholeText is TRUE and strBlockOpen or strBlockClose is empty
• bWholeText is TRUE and there is another color block definition with m_bWholeText set to TRUE.

An example of color block can be the C++ comment definition: open block - /*, close block - */, bWholeText - TRUE (meaning that this block may take several lines).

Because of nested blocks problems you can't define more than one block with bWholeText set to TRUE (it can't be more than one multiline block).

You can use the returned value for calling on RemoveBlockColor.

Parameters

strBlockOpen	Specifies the opening block pattern.
strBlockClose	Specifies the closing block pattern. Can be empty for single line blocks (like // in C++).
bWholeText	If TRUE, the block is multiline. If FALSE, the block is single line.
clrFrgnd	Specifies the block foreground color.
clrBkgnd	Specifies the block background color.
bCaseSensitive	If TRUE, the editor syntax highlighting for this block will be case sensitive.
bWholeWord	If TRUE, the function looks for the exact word.