/**
* Sets the receiver's text.
*
* <p>The string can contain both regular text and hyperlinks. A hyperlink is delimited by an
* anchor tag, <A> and </A>. Within an anchor, a single HREF attribute is supported.
* When a hyperlink is selected, the text field of the selection event contains either the text of
* the hyperlink or the value of its HREF, if one was specified. In the rare case of identical
* hyperlinks within the same string, the HREF attribute can be used to distinguish between them.
* The string may include the mnemonic character and line delimiters. The only delimiter the HREF
* attribute supports is the quotation mark (").
*
* <p>Mnemonics are indicated by an '&' that causes the next character to be the mnemonic. The
* receiver can have a mnemonic in the text preceding each link. When the user presses a key
* sequence that matches the mnemonic, focus is assigned to the link that follows the text.
* Mnemonics in links and in the trailing text are ignored. On most platforms, the mnemonic
* appears underlined but may be emphasised in a platform specific manner. The mnemonic indicator
* character '&' can be escaped by doubling it in the string, causing a single '&' to be
* displayed.
*
* @param string the new text
* @exception IllegalArgumentException
* <ul>
* <li>ERROR_NULL_ARGUMENT - if the text is null
* </ul>
*
* @exception SWTException
* <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
* </ul>
*/
public void setText(String string) {
checkWidget();
if (string == null) error(SWT.ERROR_NULL_ARGUMENT);
if (string.equals(text)) return;
text = string;
if (OS.COMCTL32_MAJOR >= 6) {
boolean enabled = OS.IsWindowEnabled(handle);
/*
* Bug in Windows. For some reason, when SetWindowText()
* is used to set the text of a link control to the empty
* string, the old text remains. The fix is to set the
* text to a space instead.
*/
if (string.length() == 0) string = " "; // $NON-NLS-1$
TCHAR buffer = new TCHAR(getCodePage(), string, true);
OS.SetWindowText(handle, buffer);
parse(text);
enableWidget(enabled);
} else {
layout.setText(parse(text));
focusIndex = offsets.length > 0 ? 0 : -1;
selection.x = selection.y = -1;
int bits = OS.GetWindowLong(handle, OS.GWL_STYLE);
if (offsets.length > 0) {
bits |= OS.WS_TABSTOP;
} else {
bits &= ~OS.WS_TABSTOP;
}
OS.SetWindowLong(handle, OS.GWL_STYLE, bits);
boolean enabled = OS.IsWindowEnabled(handle);
TextStyle linkStyle = new TextStyle(null, enabled ? linkColor : disabledColor, null);
linkStyle.underline = true;
for (int i = 0; i < offsets.length; i++) {
Point point = offsets[i];
layout.setStyle(linkStyle, point.x, point.y);
}
TextStyle mnemonicStyle = new TextStyle(null, null, null);
mnemonicStyle.underline = true;
for (int i = 0; i < mnemonics.length; i++) {
int mnemonic = mnemonics[i];
if (mnemonic != -1) {
layout.setStyle(mnemonicStyle, mnemonic, mnemonic);
}
}
redraw();
}
}
boolean mnemonicHit(char key) {
if (mnemonics != null) {
char uckey = Character.toUpperCase(key);
String parsedText = parse(text);
for (int i = 0; i < mnemonics.length - 1; i++) {
if (mnemonics[i] != -1) {
char mnemonic = parsedText.charAt(mnemonics[i]);
if (uckey == Character.toUpperCase(mnemonic)) {
if (!setFocus()) return false;
if (OS.COMCTL32_MAJOR >= 6) {
int bits = OS.GetWindowLong(handle, OS.GWL_STYLE);
LITEM item = new LITEM();
item.mask = OS.LIF_ITEMINDEX | OS.LIF_STATE;
item.stateMask = OS.LIS_FOCUSED;
while (item.iLink < mnemonics.length) {
if (item.iLink != i) OS.SendMessage(handle, OS.LM_SETITEM, 0, item);
item.iLink++;
}
item.iLink = i;
item.state = OS.LIS_FOCUSED;
OS.SendMessage(handle, OS.LM_SETITEM, 0, item);
/* Feature in Windows. For some reason, setting the focus to
* any item but first causes the control to clear the WS_TABSTOP
* bit. The fix is always to reset the bit.
*/
OS.SetWindowLong(handle, OS.GWL_STYLE, bits);
} else {
focusIndex = i;
redraw();
}
return true;
}
}
}
}
return false;
}