Mercurial > projects > dwt-addons
annotate dwtx/jface/fieldassist/ContentProposalAdapter.d @ 71:4878bef4a38e
Some fixing
| author | Frank Benoit <benoit@tionex.de> |
|---|---|
| date | Thu, 22 May 2008 04:03:58 +0200 |
| parents | 46a6e0e6ccd4 |
| children | 5df4896124c7 |
| rev | line source |
|---|---|
| 29 | 1 /******************************************************************************* |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2 * Copyright (c) 2005, 2008 IBM Corporation and others. |
| 29 | 3 * All rights reserved. This program and the accompanying materials |
| 4 * are made available under the terms of the Eclipse Public License v1.0 | |
| 5 * which accompanies this distribution, and is available at | |
| 6 * http://www.eclipse.org/legal/epl-v10.html | |
| 7 * | |
| 8 * Contributors: | |
| 9 * IBM Corporation - initial API and implementation | |
| 10 * Port to the D programming language: | |
| 11 * Frank Benoit <benoit@tionex.de> | |
| 12 *******************************************************************************/ | |
| 13 module dwtx.jface.fieldassist.ContentProposalAdapter; | |
| 14 | |
| 15 import dwtx.jface.fieldassist.IContentProposal; | |
| 16 import dwtx.jface.fieldassist.IContentProposalProvider; | |
| 17 import dwtx.jface.fieldassist.IControlContentAdapter; | |
| 18 import dwtx.jface.fieldassist.IContentProposalListener; | |
| 19 import dwtx.jface.fieldassist.IContentProposalListener2; | |
| 20 | |
| 21 import tango.util.collection.ArraySeq; | |
| 22 | |
| 23 import dwt.DWT; | |
| 24 import dwt.events.DisposeEvent; | |
| 25 import dwt.events.DisposeListener; | |
| 26 import dwt.events.FocusAdapter; | |
| 27 import dwt.events.FocusEvent; | |
| 28 import dwt.events.SelectionEvent; | |
| 29 import dwt.events.SelectionListener; | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
30 import dwt.graphics.Color; |
| 29 | 31 import dwt.graphics.Image; |
| 32 import dwt.graphics.Point; | |
| 33 import dwt.graphics.Rectangle; | |
| 34 import dwt.layout.GridData; | |
| 35 import dwt.widgets.Composite; | |
| 36 import dwt.widgets.Control; | |
| 37 import dwt.widgets.Event; | |
| 38 import dwt.widgets.Listener; | |
| 39 import dwt.widgets.ScrollBar; | |
| 40 import dwt.widgets.Shell; | |
| 41 import dwt.widgets.Table; | |
| 42 import dwt.widgets.TableItem; | |
| 43 import dwt.widgets.Text; | |
| 44 import dwtx.core.runtime.Assert; | |
| 45 import dwtx.core.runtime.ListenerList; | |
| 46 import dwtx.jface.bindings.keys.KeyStroke; | |
| 47 import dwtx.jface.dialogs.PopupDialog; | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
48 import dwtx.jface.preference.JFacePreferences; |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
49 import dwtx.jface.resource.JFaceResources; |
| 29 | 50 import dwtx.jface.viewers.ILabelProvider; |
| 51 | |
| 52 import dwt.dwthelper.utils; | |
| 53 import dwt.dwthelper.Runnable; | |
| 54 import tango.core.Thread; | |
| 55 static import tango.text.Text; | |
| 56 import tango.io.Stdout; | |
| 57 import tango.text.convert.Format; | |
| 58 alias tango.text.Text.Text!(char) StringBuffer; | |
| 59 /** | |
| 60 * ContentProposalAdapter can be used to attach content proposal behavior to a | |
| 61 * control. This behavior includes obtaining proposals, opening a popup dialog, | |
| 62 * managing the content of the control relative to the selections in the popup, | |
| 63 * and optionally opening up a secondary popup to further describe proposals. | |
| 64 * <p> | |
| 65 * A number of configurable options are provided to determine how the control | |
| 66 * content is altered when a proposal is chosen, how the content proposal popup | |
| 67 * is activated, and whether any filtering should be done on the proposals as | |
| 68 * the user types characters. | |
| 69 * <p> | |
| 70 * This class is not intended to be subclassed. | |
| 71 * | |
| 72 * @since 3.2 | |
| 73 */ | |
| 74 public class ContentProposalAdapter { | |
| 75 | |
| 76 /* | |
| 77 * The lightweight popup used to show content proposals for a text field. If | |
| 78 * additional information exists for a proposal, then selecting that | |
| 79 * proposal will result in the information being displayed in a secondary | |
| 80 * popup. | |
| 81 */ | |
| 82 class ContentProposalPopup : PopupDialog { | |
| 83 /* | |
| 84 * The listener we install on the popup and related controls to | |
| 85 * determine when to close the popup. Some events (move, resize, close, | |
| 86 * deactivate) trigger closure as soon as they are received, simply | |
| 87 * because one of the registered listeners received them. Other events | |
| 88 * depend on additional circumstances. | |
| 89 */ | |
| 90 private final class PopupCloserListener : Listener { | |
| 91 private bool scrollbarClicked = false; | |
| 92 | |
| 93 public void handleEvent(Event e) { | |
| 94 | |
| 95 // If focus is leaving an important widget or the field's | |
| 96 // shell is deactivating | |
| 97 if (e.type is DWT.FocusOut) { | |
| 98 scrollbarClicked = false; | |
| 99 /* | |
| 100 * Ignore this event if it's only happening because focus is | |
| 101 * moving between the popup shells, their controls, or a | |
| 102 * scrollbar. Do this in an async since the focus is not | |
| 103 * actually switched when this event is received. | |
| 104 */ | |
| 39 | 105 e.display.asyncExec(new class(e) Runnable { |
| 29 | 106 Event e_; |
| 39 | 107 this(Event e__){ e_=e__; } |
| 29 | 108 public void run() { |
| 109 if (isValid()) { | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
110 if (scrollbarClicked || hasFocus()) { |
| 29 | 111 return; |
| 112 } | |
| 113 // Workaround a problem on X and Mac, whereby at | |
| 114 // this point, the focus control is not known. | |
| 115 // This can happen, for example, when resizing | |
| 116 // the popup shell on the Mac. | |
| 117 // Check the active shell. | |
| 118 Shell activeShell = e_.display.getActiveShell(); | |
| 119 if (activeShell is getShell() | |
| 120 || (infoPopup !is null && infoPopup | |
| 121 .getShell() is activeShell)) { | |
| 122 return; | |
| 123 } | |
| 124 /* | |
| 125 * System.out.println(e); | |
| 126 * System.out.println(e.display.getFocusControl()); | |
| 127 * System.out.println(e.display.getActiveShell()); | |
| 128 */ | |
| 129 close(); | |
| 130 } | |
| 131 } | |
| 132 }); | |
| 133 return; | |
| 134 } | |
| 135 | |
| 136 // Scroll bar has been clicked. Remember this for focus event | |
| 137 // processing. | |
| 138 if (e.type is DWT.Selection) { | |
| 139 scrollbarClicked = true; | |
| 140 return; | |
| 141 } | |
| 142 // For all other events, merely getting them dictates closure. | |
| 143 close(); | |
| 144 } | |
| 145 | |
| 146 // Install the listeners for events that need to be monitored for | |
| 147 // popup closure. | |
| 148 void installListeners() { | |
| 149 // Listeners on this popup's table and scroll bar | |
| 150 proposalTable.addListener(DWT.FocusOut, this); | |
| 151 ScrollBar scrollbar = proposalTable.getVerticalBar(); | |
| 152 if (scrollbar !is null) { | |
| 153 scrollbar.addListener(DWT.Selection, this); | |
| 154 } | |
| 155 | |
| 156 // Listeners on this popup's shell | |
| 157 getShell().addListener(DWT.Deactivate, this); | |
| 158 getShell().addListener(DWT.Close, this); | |
| 159 | |
| 160 // Listeners on the target control | |
| 161 control.addListener(DWT.MouseDoubleClick, this); | |
| 162 control.addListener(DWT.MouseDown, this); | |
| 163 control.addListener(DWT.Dispose, this); | |
| 164 control.addListener(DWT.FocusOut, this); | |
| 165 // Listeners on the target control's shell | |
| 166 Shell controlShell = control.getShell(); | |
| 167 controlShell.addListener(DWT.Move, this); | |
| 168 controlShell.addListener(DWT.Resize, this); | |
| 169 | |
| 170 } | |
| 171 | |
| 172 // Remove installed listeners | |
| 173 void removeListeners() { | |
| 174 if (isValid()) { | |
| 175 proposalTable.removeListener(DWT.FocusOut, this); | |
| 176 ScrollBar scrollbar = proposalTable.getVerticalBar(); | |
| 177 if (scrollbar !is null) { | |
| 178 scrollbar.removeListener(DWT.Selection, this); | |
| 179 } | |
| 180 | |
| 181 getShell().removeListener(DWT.Deactivate, this); | |
| 182 getShell().removeListener(DWT.Close, this); | |
| 183 } | |
| 184 | |
| 185 if (control !is null && !control.isDisposed()) { | |
| 186 | |
| 187 control.removeListener(DWT.MouseDoubleClick, this); | |
| 188 control.removeListener(DWT.MouseDown, this); | |
| 189 control.removeListener(DWT.Dispose, this); | |
| 190 control.removeListener(DWT.FocusOut, this); | |
| 191 | |
| 192 Shell controlShell = control.getShell(); | |
| 193 controlShell.removeListener(DWT.Move, this); | |
| 194 controlShell.removeListener(DWT.Resize, this); | |
| 195 } | |
| 196 } | |
| 197 } | |
| 198 | |
| 199 /* | |
| 200 * The listener we will install on the target control. | |
| 201 */ | |
| 202 private final class TargetControlListener : Listener { | |
| 203 // Key events from the control | |
| 204 public void handleEvent(Event e) { | |
| 205 if (!isValid()) { | |
| 206 return; | |
| 207 } | |
| 208 | |
| 209 char key = e.character; | |
| 210 | |
| 211 // Traverse events are handled depending on whether the | |
| 212 // event has a character. | |
| 213 if (e.type is DWT.Traverse) { | |
| 214 // If the traverse event contains a legitimate character, | |
| 215 // then we must set doit false so that the widget will | |
| 216 // receive the key event. We return immediately so that | |
| 217 // the character is handled only in the key event. | |
| 218 // See https://bugs.eclipse.org/bugs/show_bug.cgi?id=132101 | |
| 219 if (key !is 0) { | |
| 220 e.doit = false; | |
| 221 return; | |
| 222 } | |
| 223 // Traversal does not contain a character. Set doit true | |
| 224 // to indicate TRAVERSE_NONE will occur and that no key | |
| 225 // event will be triggered. We will check for navigation | |
| 226 // keys below. | |
| 227 e.detail = DWT.TRAVERSE_NONE; | |
| 228 e.doit = true; | |
| 229 } else { | |
| 230 // Default is to only propagate when configured that way. | |
| 231 // Some keys will always set doit to false anyway. | |
| 232 e.doit = propagateKeys; | |
| 233 } | |
| 234 | |
| 235 // No character. Check for navigation keys. | |
| 236 | |
| 237 if (key is 0) { | |
| 238 int newSelection = proposalTable.getSelectionIndex(); | |
| 239 int visibleRows = (proposalTable.getSize().y / proposalTable | |
| 240 .getItemHeight()) - 1; | |
| 241 switch (e.keyCode) { | |
| 242 case DWT.ARROW_UP: | |
| 243 newSelection -= 1; | |
| 244 if (newSelection < 0) { | |
| 245 newSelection = proposalTable.getItemCount() - 1; | |
| 246 } | |
| 247 // Not typical - usually we get this as a Traverse and | |
| 248 // therefore it never propagates. Added for consistency. | |
| 249 if (e.type is DWT.KeyDown) { | |
| 250 // don't propagate to control | |
| 251 e.doit = false; | |
| 252 } | |
| 253 | |
| 254 break; | |
| 255 | |
| 256 case DWT.ARROW_DOWN: | |
| 257 newSelection += 1; | |
| 258 if (newSelection > proposalTable.getItemCount() - 1) { | |
| 259 newSelection = 0; | |
| 260 } | |
| 261 // Not typical - usually we get this as a Traverse and | |
| 262 // therefore it never propagates. Added for consistency. | |
| 263 if (e.type is DWT.KeyDown) { | |
| 264 // don't propagate to control | |
| 265 e.doit = false; | |
| 266 } | |
| 267 | |
| 268 break; | |
| 269 | |
| 270 case DWT.PAGE_DOWN: | |
| 271 newSelection += visibleRows; | |
| 272 if (newSelection >= proposalTable.getItemCount()) { | |
| 273 newSelection = proposalTable.getItemCount() - 1; | |
| 274 } | |
| 275 if (e.type is DWT.KeyDown) { | |
| 276 // don't propagate to control | |
| 277 e.doit = false; | |
| 278 } | |
| 279 break; | |
| 280 | |
| 281 case DWT.PAGE_UP: | |
| 282 newSelection -= visibleRows; | |
| 283 if (newSelection < 0) { | |
| 284 newSelection = 0; | |
| 285 } | |
| 286 if (e.type is DWT.KeyDown) { | |
| 287 // don't propagate to control | |
| 288 e.doit = false; | |
| 289 } | |
| 290 break; | |
| 291 | |
| 292 case DWT.HOME: | |
| 293 newSelection = 0; | |
| 294 if (e.type is DWT.KeyDown) { | |
| 295 // don't propagate to control | |
| 296 e.doit = false; | |
| 297 } | |
| 298 break; | |
| 299 | |
| 300 case DWT.END: | |
| 301 newSelection = proposalTable.getItemCount() - 1; | |
| 302 if (e.type is DWT.KeyDown) { | |
| 303 // don't propagate to control | |
| 304 e.doit = false; | |
| 305 } | |
| 306 break; | |
| 307 | |
| 308 // If received as a Traverse, these should propagate | |
| 309 // to the control as keydown. If received as a keydown, | |
| 310 // proposals should be recomputed since the cursor | |
| 311 // position has changed. | |
| 312 case DWT.ARROW_LEFT: | |
| 313 case DWT.ARROW_RIGHT: | |
| 314 if (e.type is DWT.Traverse) { | |
| 315 e.doit = false; | |
| 316 } else { | |
| 317 e.doit = true; | |
| 318 String contents = getControlContentAdapter() | |
| 319 .getControlContents(getControl()); | |
| 320 // If there are no contents, changes in cursor | |
| 71 | 321 // position have no effect. Note also that we do |
| 322 // not affect the filter text on ARROW_LEFT as | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
323 // we would with BS. |
| 29 | 324 if (contents.length > 0) { |
| 325 asyncRecomputeProposals(filterText); | |
| 326 } | |
| 327 } | |
| 328 break; | |
| 329 | |
| 330 // Any unknown keycodes will cause the popup to close. | |
| 331 // Modifier keys are explicitly checked and ignored because | |
| 332 // they are not complete yet (no character). | |
| 333 default: | |
| 334 if (e.keyCode !is DWT.CAPS_LOCK && e.keyCode !is DWT.MOD1 | |
| 335 && e.keyCode !is DWT.MOD2 | |
| 336 && e.keyCode !is DWT.MOD3 | |
| 337 && e.keyCode !is DWT.MOD4) { | |
| 338 close(); | |
| 339 } | |
| 340 return; | |
| 341 } | |
| 342 | |
| 343 // If any of these navigation events caused a new selection, | |
| 344 // then handle that now and return. | |
| 345 if (newSelection >= 0) { | |
| 346 selectProposal(newSelection); | |
| 347 } | |
| 348 return; | |
| 349 } | |
| 350 | |
| 351 // key !is 0 | |
| 352 // Check for special keys involved in cancelling, accepting, or | |
| 353 // filtering the proposals. | |
| 354 switch (key) { | |
| 355 case DWT.ESC: | |
| 356 e.doit = false; | |
| 357 close(); | |
| 358 break; | |
| 359 | |
| 360 case DWT.LF: | |
| 361 case DWT.CR: | |
| 362 e.doit = false; | |
| 363 Object p = cast(Object)getSelectedProposal(); | |
| 364 if (p !is null) { | |
| 365 acceptCurrentProposal(); | |
| 366 } else { | |
| 367 close(); | |
| 368 } | |
| 369 break; | |
| 370 | |
| 371 case DWT.TAB: | |
| 372 e.doit = false; | |
| 373 getShell().setFocus(); | |
| 374 return; | |
| 375 | |
| 376 case DWT.BS: | |
| 377 // Backspace should back out of any stored filter text | |
| 378 if (filterStyle !is FILTER_NONE) { | |
| 379 // We have no filter to back out of, so do nothing | |
| 380 if (filterText.length is 0) { | |
| 381 return; | |
| 382 } | |
| 383 // There is filter to back out of | |
| 384 filterText = filterText.substring(0, filterText | |
| 385 .length - 1); | |
| 386 asyncRecomputeProposals(filterText); | |
| 387 return; | |
| 388 } | |
| 389 // There is no filtering provided by us, but some | |
| 390 // clients provide their own filtering based on content. | |
| 391 // Recompute the proposals if the cursor position | |
| 392 // will change (is not at 0). | |
| 393 int pos = getControlContentAdapter().getCursorPosition( | |
| 394 getControl()); | |
| 395 // We rely on the fact that the contents and pos do not yet | |
| 396 // reflect the result of the BS. If the contents were | |
| 397 // already empty, then BS should not cause | |
| 398 // a recompute. | |
| 399 if (pos > 0) { | |
| 400 asyncRecomputeProposals(filterText); | |
| 401 } | |
| 402 break; | |
| 403 | |
| 404 default: | |
| 405 // If the key is a defined unicode character, and not one of | |
| 406 // the special cases processed above, update the filter text | |
| 407 // and filter the proposals. | |
| 408 if (CharacterIsDefined(key)) { | |
| 409 if (filterStyle is FILTER_CUMULATIVE) { | |
| 410 filterText = filterText ~ dcharToString(key); | |
| 411 } else if (filterStyle is FILTER_CHARACTER) { | |
| 412 filterText = dcharToString(key); | |
| 413 } | |
| 414 // Recompute proposals after processing this event. | |
| 415 asyncRecomputeProposals(filterText); | |
| 416 } | |
| 417 break; | |
| 418 } | |
| 419 } | |
| 420 } | |
| 421 | |
| 422 /* | |
| 423 * Internal class used to implement the secondary popup. | |
| 424 */ | |
| 425 private class InfoPopupDialog : PopupDialog { | |
| 426 | |
| 427 /* | |
| 428 * The text control that displays the text. | |
| 429 */ | |
| 430 private Text text; | |
| 431 | |
| 432 /* | |
| 433 * The String shown in the popup. | |
| 434 */ | |
| 435 private String contents = EMPTY; | |
| 436 | |
| 437 /* | |
| 438 * Construct an info-popup with the specified parent. | |
| 439 */ | |
| 440 this(Shell parent) { | |
| 441 super(parent, PopupDialog.HOVER_SHELLSTYLE, false, false, | |
| 442 false, false, null, null); | |
| 443 } | |
| 444 | |
| 445 /* | |
| 446 * Create a text control for showing the info about a proposal. | |
| 447 */ | |
|
43
ea8ff534f622
Fix override and super aliases
Frank Benoit <benoit@tionex.de>
parents:
39
diff
changeset
|
448 protected override Control createDialogArea(Composite parent) { |
| 29 | 449 text = new Text(parent, DWT.MULTI | DWT.READ_ONLY | DWT.WRAP |
| 450 | DWT.NO_FOCUS); | |
| 451 | |
| 452 // Use the compact margins employed by PopupDialog. | |
| 453 GridData gd = new GridData(GridData.BEGINNING | |
| 454 | GridData.FILL_BOTH); | |
| 455 gd.horizontalIndent = PopupDialog.POPUP_HORIZONTALSPACING; | |
| 456 gd.verticalIndent = PopupDialog.POPUP_VERTICALSPACING; | |
| 457 text.setLayoutData(gd); | |
| 458 text.setText(contents); | |
| 459 | |
| 460 // since DWT.NO_FOCUS is only a hint... | |
| 461 text.addFocusListener(new class FocusAdapter { | |
| 462 public void focusGained(FocusEvent event) { | |
| 463 this.outer.close(); | |
| 464 } | |
| 465 }); | |
| 466 return text; | |
| 467 } | |
| 468 | |
| 469 /* | |
| 470 * Adjust the bounds so that we appear adjacent to our parent shell | |
| 471 */ | |
|
43
ea8ff534f622
Fix override and super aliases
Frank Benoit <benoit@tionex.de>
parents:
39
diff
changeset
|
472 protected override void adjustBounds() { |
| 29 | 473 Rectangle parentBounds = getParentShell().getBounds(); |
| 474 Rectangle proposedBounds; | |
| 475 // Try placing the info popup to the right | |
| 476 Rectangle rightProposedBounds = new Rectangle(parentBounds.x | |
| 477 + parentBounds.width | |
| 478 + PopupDialog.POPUP_HORIZONTALSPACING, parentBounds.y | |
| 479 + PopupDialog.POPUP_VERTICALSPACING, | |
| 480 parentBounds.width, parentBounds.height); | |
| 481 rightProposedBounds = getConstrainedShellBounds(rightProposedBounds); | |
| 482 // If it won't fit on the right, try the left | |
| 483 if (rightProposedBounds.intersects(parentBounds)) { | |
| 484 Rectangle leftProposedBounds = new Rectangle(parentBounds.x | |
| 485 - parentBounds.width - POPUP_HORIZONTALSPACING - 1, | |
| 486 parentBounds.y, parentBounds.width, | |
| 487 parentBounds.height); | |
| 488 leftProposedBounds = getConstrainedShellBounds(leftProposedBounds); | |
| 489 // If it won't fit on the left, choose the proposed bounds | |
| 490 // that fits the best | |
| 491 if (leftProposedBounds.intersects(parentBounds)) { | |
| 492 if (rightProposedBounds.x - parentBounds.x >= parentBounds.x | |
| 493 - leftProposedBounds.x) { | |
| 494 rightProposedBounds.x = parentBounds.x | |
| 495 + parentBounds.width | |
| 496 + PopupDialog.POPUP_HORIZONTALSPACING; | |
| 497 proposedBounds = rightProposedBounds; | |
| 498 } else { | |
| 499 leftProposedBounds.width = parentBounds.x | |
| 500 - POPUP_HORIZONTALSPACING | |
| 501 - leftProposedBounds.x; | |
| 502 proposedBounds = leftProposedBounds; | |
| 503 } | |
| 504 } else { | |
| 505 // use the proposed bounds on the left | |
| 506 proposedBounds = leftProposedBounds; | |
| 507 } | |
| 508 } else { | |
| 509 // use the proposed bounds on the right | |
| 510 proposedBounds = rightProposedBounds; | |
| 511 } | |
| 512 getShell().setBounds(proposedBounds); | |
| 513 } | |
| 71 | 514 |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
515 /* |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
516 * (non-Javadoc) |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
517 * @see dwtx.jface.dialogs.PopupDialog#getForeground() |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
518 */ |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
519 protected Color getForeground() { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
520 return control.getDisplay(). |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
521 getSystemColor(DWT.COLOR_INFO_FOREGROUND); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
522 } |
| 71 | 523 |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
524 /* |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
525 * (non-Javadoc) |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
526 * @see dwtx.jface.dialogs.PopupDialog#getBackground() |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
527 */ |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
528 protected Color getBackground() { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
529 return control.getDisplay(). |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
530 getSystemColor(DWT.COLOR_INFO_BACKGROUND); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
531 } |
| 29 | 532 |
| 533 /* | |
| 534 * Set the text contents of the popup. | |
| 535 */ | |
| 536 void setContents(String newContents) { | |
| 537 if (newContents is null) { | |
| 538 newContents = EMPTY; | |
| 539 } | |
| 540 this.contents = newContents; | |
| 541 if (text !is null && !text.isDisposed()) { | |
| 542 text.setText(contents); | |
| 543 } | |
| 544 } | |
| 545 | |
| 546 /* | |
| 547 * Return whether the popup has focus. | |
| 548 */ | |
| 549 bool hasFocus() { | |
| 550 if (text is null || text.isDisposed()) { | |
| 551 return false; | |
| 552 } | |
| 553 return text.getShell().isFocusControl() | |
| 554 || text.isFocusControl(); | |
| 555 } | |
| 556 } | |
| 557 | |
| 558 /* | |
| 559 * The listener installed on the target control. | |
| 560 */ | |
| 561 private Listener targetControlListener; | |
| 562 | |
| 563 /* | |
| 564 * The listener installed in order to close the popup. | |
| 565 */ | |
| 566 private PopupCloserListener popupCloser; | |
| 567 | |
| 568 /* | |
| 569 * The table used to show the list of proposals. | |
| 570 */ | |
| 571 private Table proposalTable; | |
| 572 | |
| 573 /* | |
| 574 * The proposals to be shown (cached to avoid repeated requests). | |
| 575 */ | |
| 576 private IContentProposal[] proposals; | |
| 577 | |
| 578 /* | |
| 579 * Secondary popup used to show detailed information about the selected | |
| 580 * proposal.. | |
| 581 */ | |
| 582 private InfoPopupDialog infoPopup; | |
| 583 | |
| 584 /* | |
| 585 * Flag indicating whether there is a pending secondary popup update. | |
| 586 */ | |
| 587 private bool pendingDescriptionUpdate = false; | |
| 588 | |
| 589 /* | |
| 590 * Filter text - tracked while popup is open, only if we are told to | |
| 591 * filter | |
| 592 */ | |
| 593 private String filterText = EMPTY; | |
| 594 | |
| 595 /** | |
| 596 * Constructs a new instance of this popup, specifying the control for | |
| 597 * which this popup is showing content, and how the proposals should be | |
| 598 * obtained and displayed. | |
| 599 * | |
| 600 * @param infoText | |
| 601 * Text to be shown in a lower info area, or | |
| 602 * <code>null</code> if there is no info area. | |
| 603 */ | |
| 604 this(String infoText, IContentProposal[] proposals) { | |
| 605 // IMPORTANT: Use of DWT.ON_TOP is critical here for ensuring | |
| 606 // that the target control retains focus on Mac and Linux. Without | |
| 607 // it, the focus will disappear, keystrokes will not go to the | |
| 608 // popup, and the popup closer will wrongly close the popup. | |
| 609 // On platforms where DWT.ON_TOP overrides DWT.RESIZE, we will live | |
| 610 // with this. | |
| 611 // See https://bugs.eclipse.org/bugs/show_bug.cgi?id=126138 | |
| 612 super(control.getShell(), DWT.RESIZE | DWT.ON_TOP, false, false, | |
| 613 false, false, null, infoText); | |
| 614 this.proposals = proposals; | |
| 615 } | |
| 616 | |
| 617 /* | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
618 * (non-Javadoc) |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
619 * @see dwtx.jface.dialogs.PopupDialog#getForeground() |
| 29 | 620 */ |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
621 protected Color getForeground() { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
622 return JFaceResources.getColorRegistry().get( |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
623 JFacePreferences.CONTENT_ASSIST_FOREGROUND_COLOR); |
| 29 | 624 } |
| 71 | 625 |
| 29 | 626 /* |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
627 * (non-Javadoc) |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
628 * @see dwtx.jface.dialogs.PopupDialog#getBackground() |
| 29 | 629 */ |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
630 protected Color getBackground() { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
631 return JFaceResources.getColorRegistry().get( |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
632 JFacePreferences.CONTENT_ASSIST_BACKGROUND_COLOR); |
| 29 | 633 } |
| 634 | |
| 635 /* | |
| 636 * Creates the content area for the proposal popup. This creates a table | |
| 637 * and places it inside the composite. The table will contain a list of | |
| 638 * all the proposals. | |
| 639 * | |
| 640 * @param parent The parent composite to contain the dialog area; must | |
| 641 * not be <code>null</code>. | |
| 642 */ | |
|
43
ea8ff534f622
Fix override and super aliases
Frank Benoit <benoit@tionex.de>
parents:
39
diff
changeset
|
643 protected override final Control createDialogArea(Composite parent) { |
| 29 | 644 // Use virtual where appropriate (see flag definition). |
| 645 if (USE_VIRTUAL) { | |
| 646 proposalTable = new Table(parent, DWT.H_SCROLL | DWT.V_SCROLL | |
| 647 | DWT.VIRTUAL); | |
| 648 | |
| 649 Listener listener = new class Listener { | |
| 650 public void handleEvent(Event event) { | |
| 651 handleSetData(event); | |
| 652 } | |
| 653 }; | |
| 654 proposalTable.addListener(DWT.SetData, listener); | |
| 655 } else { | |
| 656 proposalTable = new Table(parent, DWT.H_SCROLL | DWT.V_SCROLL); | |
| 657 } | |
| 658 | |
| 659 // set the proposals to force population of the table. | |
| 660 setProposals(filterProposals(proposals, filterText)); | |
| 661 | |
| 662 proposalTable.setHeaderVisible(false); | |
| 663 proposalTable.addSelectionListener(new class SelectionListener { | |
| 664 | |
| 665 public void widgetSelected(SelectionEvent e) { | |
| 666 // If a proposal has been selected, show it in the secondary | |
| 667 // popup. Otherwise close the popup. | |
| 668 if (e.item is null) { | |
| 669 if (infoPopup !is null) { | |
| 670 infoPopup.close(); | |
| 671 } | |
| 672 } else { | |
| 673 showProposalDescription(); | |
| 674 } | |
| 675 } | |
| 676 | |
| 677 // Default selection was made. Accept the current proposal. | |
| 678 public void widgetDefaultSelected(SelectionEvent e) { | |
| 679 acceptCurrentProposal(); | |
| 680 } | |
| 681 }); | |
| 682 return proposalTable; | |
| 683 } | |
| 684 | |
| 685 /* | |
| 686 * (non-Javadoc) | |
| 687 * | |
| 688 * @see dwtx.jface.dialogs.PopupDialog.adjustBounds() | |
| 689 */ | |
|
43
ea8ff534f622
Fix override and super aliases
Frank Benoit <benoit@tionex.de>
parents:
39
diff
changeset
|
690 protected override void adjustBounds() { |
| 29 | 691 // Get our control's location in display coordinates. |
| 692 Point location = control.getDisplay().map(control.getParent(), | |
| 693 null, control.getLocation()); | |
| 694 int initialX = location.x + POPUP_OFFSET; | |
| 695 int initialY = location.y + control.getSize().y + POPUP_OFFSET; | |
| 696 // If we are inserting content, use the cursor position to | |
| 697 // position the control. | |
| 698 if (getProposalAcceptanceStyle() is PROPOSAL_INSERT) { | |
| 699 Rectangle insertionBounds = controlContentAdapter | |
| 700 .getInsertionBounds(control); | |
| 701 initialX = initialX + insertionBounds.x; | |
| 702 initialY = location.y + insertionBounds.y | |
| 703 + insertionBounds.height; | |
| 704 } | |
| 705 | |
| 706 // If there is no specified size, force it by setting | |
| 707 // up a layout on the table. | |
| 708 if (popupSize is null) { | |
| 709 GridData data = new GridData(GridData.FILL_BOTH); | |
| 710 data.heightHint = proposalTable.getItemHeight() | |
| 711 * POPUP_CHAR_HEIGHT; | |
| 712 data.widthHint = Math.max(control.getSize().x, | |
| 713 POPUP_MINIMUM_WIDTH); | |
| 714 proposalTable.setLayoutData(data); | |
| 715 getShell().pack(); | |
| 716 popupSize = getShell().getSize(); | |
| 717 } | |
| 718 getShell().setBounds(initialX, initialY, popupSize.x, popupSize.y); | |
| 719 | |
| 720 // Now set up a listener to monitor any changes in size. | |
| 721 getShell().addListener(DWT.Resize, new class Listener { | |
| 722 public void handleEvent(Event e) { | |
| 723 popupSize = getShell().getSize(); | |
| 724 if (infoPopup !is null) { | |
| 725 infoPopup.adjustBounds(); | |
| 726 } | |
| 727 } | |
| 728 }); | |
| 729 } | |
| 730 | |
| 731 /* | |
| 732 * Handle the set data event. Set the item data of the requested item to | |
| 733 * the corresponding proposal in the proposal cache. | |
| 734 */ | |
| 735 private void handleSetData(Event event) { | |
| 736 TableItem item = cast(TableItem) event.item; | |
| 737 int index = proposalTable.indexOf(item); | |
| 738 | |
| 739 if (0 <= index && index < proposals.length) { | |
| 740 IContentProposal current = proposals[index]; | |
| 741 item.setText(getString(current)); | |
| 742 item.setImage(getImage(current)); | |
| 743 item.setData(cast(Object)current); | |
| 744 } else { | |
| 745 // this should not happen, but does on win32 | |
| 746 } | |
| 747 } | |
| 748 | |
| 749 /* | |
| 750 * Caches the specified proposals and repopulates the table if it has | |
| 751 * been created. | |
| 752 */ | |
| 753 private void setProposals(IContentProposal[] newProposals) { | |
| 754 if (newProposals is null || newProposals.length is 0) { | |
| 755 newProposals = getEmptyProposalArray(); | |
| 756 } | |
| 757 this.proposals = newProposals; | |
| 758 | |
| 759 // If there is a table | |
| 760 if (isValid()) { | |
| 761 final int newSize = newProposals.length; | |
| 762 if (USE_VIRTUAL) { | |
| 763 // Set and clear the virtual table. Data will be | |
| 764 // provided in the DWT.SetData event handler. | |
| 765 proposalTable.setItemCount(newSize); | |
| 766 proposalTable.clearAll(); | |
| 767 } else { | |
| 768 // Populate the table manually | |
| 769 proposalTable.setRedraw(false); | |
| 770 proposalTable.setItemCount(newSize); | |
| 771 TableItem[] items = proposalTable.getItems(); | |
| 772 for (int i = 0; i < items.length; i++) { | |
| 773 TableItem item = items[i]; | |
| 774 IContentProposal proposal = newProposals[i]; | |
| 775 item.setText(getString(proposal)); | |
| 776 item.setImage(getImage(proposal)); | |
| 777 item.setData(cast(Object)proposal); | |
| 778 } | |
| 779 proposalTable.setRedraw(true); | |
| 780 } | |
| 781 // Default to the first selection if there is content. | |
| 782 if (newProposals.length > 0) { | |
| 783 selectProposal(0); | |
| 784 } else { | |
| 785 // No selection, close the secondary popup if it was open | |
| 786 if (infoPopup !is null) { | |
| 787 infoPopup.close(); | |
| 788 } | |
| 789 | |
| 790 } | |
| 791 } | |
| 792 } | |
| 793 | |
| 794 /* | |
| 795 * Get the string for the specified proposal. Always return a String of | |
| 796 * some kind. | |
| 797 */ | |
| 798 private String getString(IContentProposal proposal) { | |
| 799 if (proposal is null) { | |
| 800 return EMPTY; | |
| 801 } | |
| 802 if (labelProvider is null) { | |
| 803 return proposal.getLabel() is null ? proposal.getContent() | |
| 804 : proposal.getLabel(); | |
| 805 } | |
| 806 return labelProvider.getText(cast(Object)proposal); | |
| 807 } | |
| 808 | |
| 809 /* | |
| 810 * Get the image for the specified proposal. If there is no image | |
| 811 * available, return null. | |
| 812 */ | |
| 813 private Image getImage(IContentProposal proposal) { | |
| 814 if (proposal is null || labelProvider is null) { | |
| 815 return null; | |
| 816 } | |
| 817 return labelProvider.getImage(cast(Object)proposal); | |
| 818 } | |
| 819 | |
| 820 /* | |
| 821 * Return an empty array. Used so that something always shows in the | |
| 822 * proposal popup, even if no proposal provider was specified. | |
| 823 */ | |
| 824 private IContentProposal[] getEmptyProposalArray() { | |
| 825 return new IContentProposal[0]; | |
| 826 } | |
| 827 | |
| 828 /* | |
| 829 * Answer true if the popup is valid, which means the table has been | |
| 830 * created and not disposed. | |
| 831 */ | |
| 832 private bool isValid() { | |
| 833 return proposalTable !is null && !proposalTable.isDisposed(); | |
| 834 } | |
| 835 | |
| 836 /* | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
837 * Return whether the receiver has focus. Since 3.4, this includes a |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
838 * check for whether the info popup has focus. |
| 29 | 839 */ |
| 840 private bool hasFocus() { | |
| 841 if (!isValid()) { | |
| 842 return false; | |
| 843 } | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
844 if (getShell().isFocusControl() || proposalTable.isFocusControl()) { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
845 return true; |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
846 } |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
847 if (infoPopup !is null && infoPopup.hasFocus()) { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
848 return true; |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
849 } |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
850 return false; |
| 29 | 851 } |
| 852 | |
| 853 /* | |
| 854 * Return the current selected proposal. | |
| 855 */ | |
| 856 private IContentProposal getSelectedProposal() { | |
| 857 if (isValid()) { | |
| 858 int i = proposalTable.getSelectionIndex(); | |
| 859 if (proposals is null || i < 0 || i >= proposals.length) { | |
| 860 return null; | |
| 861 } | |
| 862 return proposals[i]; | |
| 863 } | |
| 864 return null; | |
| 865 } | |
| 866 | |
| 867 /* | |
| 868 * Select the proposal at the given index. | |
| 869 */ | |
| 870 private void selectProposal(int index) { | |
| 871 Assert | |
| 872 .isTrue(index >= 0, | |
| 873 "Proposal index should never be negative"); //$NON-NLS-1$ | |
| 874 if (!isValid() || proposals is null || index >= proposals.length) { | |
| 875 return; | |
| 876 } | |
| 877 proposalTable.setSelection(index); | |
| 878 proposalTable.showSelection(); | |
| 879 | |
| 880 showProposalDescription(); | |
| 881 } | |
| 882 | |
| 883 /** | |
| 884 * Opens this ContentProposalPopup. This method is extended in order to | |
| 885 * add the control listener when the popup is opened and to invoke the | |
| 886 * secondary popup if applicable. | |
| 887 * | |
| 888 * @return the return code | |
| 889 * | |
| 890 * @see dwtx.jface.window.Window#open() | |
| 891 */ | |
|
43
ea8ff534f622
Fix override and super aliases
Frank Benoit <benoit@tionex.de>
parents:
39
diff
changeset
|
892 public override int open() { |
| 29 | 893 int value = super.open(); |
| 894 if (popupCloser is null) { | |
| 895 popupCloser = new PopupCloserListener(); | |
| 896 } | |
| 897 popupCloser.installListeners(); | |
| 898 IContentProposal p = getSelectedProposal(); | |
| 899 if (p !is null) { | |
| 900 showProposalDescription(); | |
| 901 } | |
| 902 return value; | |
| 903 } | |
| 904 | |
| 905 /** | |
| 906 * Closes this popup. This method is extended to remove the control | |
| 907 * listener. | |
| 908 * | |
| 909 * @return <code>true</code> if the window is (or was already) closed, | |
| 910 * and <code>false</code> if it is still open | |
| 911 */ | |
|
43
ea8ff534f622
Fix override and super aliases
Frank Benoit <benoit@tionex.de>
parents:
39
diff
changeset
|
912 public override bool close() { |
| 29 | 913 popupCloser.removeListeners(); |
| 914 if (infoPopup !is null) { | |
| 915 infoPopup.close(); | |
| 916 } | |
| 917 bool ret = super.close(); | |
| 918 notifyPopupClosed(); | |
| 919 return ret; | |
| 920 } | |
| 921 | |
| 922 /* | |
| 923 * Show the currently selected proposal's description in a secondary | |
| 924 * popup. | |
| 925 */ | |
| 926 private void showProposalDescription() { | |
| 927 // If we do not already have a pending update, then | |
| 928 // create a thread now that will show the proposal description | |
| 929 if (!pendingDescriptionUpdate) { | |
| 930 // Create a thread that will sleep for the specified delay | |
| 931 // before creating the popup. We do not use Jobs since this | |
| 932 // code must be able to run independently of the Eclipse | |
| 933 // runtime. | |
| 934 auto r = new class() Runnable { | |
| 935 public void run() { | |
| 936 pendingDescriptionUpdate = true; | |
| 937 | |
| 938 try { | |
| 939 Thread.sleep( POPUP_DELAY / 1000.0 ); | |
| 940 } | |
| 941 catch (InterruptedException e) { | |
| 942 } | |
| 943 | |
| 944 if (!isValid()) { | |
| 945 return; | |
| 946 } | |
| 947 getShell().getDisplay().syncExec(new class() Runnable { | |
| 948 public void run() { | |
| 949 // Query the current selection since we have | |
| 950 // been delayed | |
| 951 IContentProposal p = getSelectedProposal(); | |
| 952 if (p !is null) { | |
| 953 String description = p.getDescription(); | |
| 954 if (description !is null) { | |
| 955 if (infoPopup is null) { | |
| 956 infoPopup = new InfoPopupDialog( | |
| 957 getShell()); | |
| 958 infoPopup.open(); | |
| 959 infoPopup | |
| 960 .getShell() | |
| 961 .addDisposeListener( | |
| 962 new class DisposeListener { | |
| 963 public void widgetDisposed( | |
| 964 DisposeEvent event) { | |
| 965 infoPopup = null; | |
| 966 } | |
| 967 }); | |
| 968 } | |
| 969 infoPopup.setContents(p | |
| 970 .getDescription()); | |
| 971 } else if (infoPopup !is null) { | |
| 972 infoPopup.close(); | |
| 973 } | |
| 974 pendingDescriptionUpdate = false; | |
| 975 | |
| 976 } | |
| 977 } | |
| 978 }); | |
| 979 } | |
| 980 }; | |
| 981 Thread t = new Thread(&r.run); | |
| 982 t.start(); | |
| 983 } | |
| 984 } | |
| 985 | |
| 986 /* | |
| 987 * Accept the current proposal. | |
| 988 */ | |
| 989 private void acceptCurrentProposal() { | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
990 // Close before accepting the proposal. This is important |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
991 // so that the cursor position can be properly restored at |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
992 // acceptance, which does not work without focus on some controls. |
| 29 | 993 // See https://bugs.eclipse.org/bugs/show_bug.cgi?id=127108 |
| 994 IContentProposal proposal = getSelectedProposal(); | |
| 995 close(); | |
| 996 proposalAccepted(proposal); | |
| 997 } | |
| 998 | |
| 999 /* | |
| 1000 * Request the proposals from the proposal provider, and recompute any | |
| 1001 * caches. Repopulate the popup if it is open. | |
| 1002 */ | |
| 1003 private void recomputeProposals(String filterText) { | |
| 1004 IContentProposal[] allProposals = getProposals(); | |
| 1005 // If the non-filtered proposal list is empty, we should | |
| 1006 // close the popup. | |
| 1007 // See https://bugs.eclipse.org/bugs/show_bug.cgi?id=147377 | |
| 1008 if (allProposals.length is 0) { | |
| 1009 proposals = allProposals; | |
| 1010 close(); | |
| 1011 } else { | |
| 1012 // Keep the popup open, but filter by any provided filter text | |
| 1013 setProposals(filterProposals(allProposals, filterText)); | |
| 1014 } | |
| 1015 } | |
| 1016 | |
| 1017 /* | |
| 1018 * In an async block, request the proposals. This is used when clients | |
| 1019 * are in the middle of processing an event that affects the widget | |
| 1020 * content. By using an async, we ensure that the widget content is up | |
| 1021 * to date with the event. | |
| 1022 */ | |
| 1023 private void asyncRecomputeProposals(String filterText) { | |
| 1024 if (isValid()) { | |
| 39 | 1025 control.getDisplay().asyncExec(new class(filterText) Runnable { |
| 29 | 1026 String filterText_; |
| 39 | 1027 this(String a){filterText_=a;} |
| 29 | 1028 public void run() { |
| 1029 recordCursorPosition(); | |
| 1030 recomputeProposals(filterText_); | |
| 1031 } | |
| 1032 }); | |
| 1033 } else { | |
| 1034 recomputeProposals(filterText); | |
| 1035 } | |
| 1036 } | |
| 1037 | |
| 1038 /* | |
| 1039 * Filter the provided list of content proposals according to the filter | |
| 1040 * text. | |
| 1041 */ | |
| 1042 private IContentProposal[] filterProposals( | |
| 1043 IContentProposal[] proposals, String filterString) { | |
| 1044 if (filterString.length is 0) { | |
| 1045 return proposals; | |
| 1046 } | |
| 1047 | |
| 1048 // Check each string for a match. Use the string displayed to the | |
| 1049 // user, not the proposal content. | |
| 1050 auto list = new ArraySeq!(IContentProposal); | |
| 1051 for (int i = 0; i < proposals.length; i++) { | |
| 1052 String string = getString(proposals[i]); | |
| 1053 if (string.length >= filterString.length | |
| 1054 && string.substring(0, filterString.length) | |
| 1055 .equalsIgnoreCase(filterString)) { | |
| 1056 list.append(proposals[i]); | |
| 1057 } | |
| 1058 | |
| 1059 } | |
| 1060 return list.toArray(); | |
| 1061 } | |
| 1062 | |
| 1063 Listener getTargetControlListener() { | |
| 1064 if (targetControlListener is null) { | |
| 1065 targetControlListener = new TargetControlListener(); | |
| 1066 } | |
| 1067 return targetControlListener; | |
| 1068 } | |
| 1069 } | |
| 1070 | |
| 1071 /** | |
| 1072 * Flag that controls the printing of debug info. | |
| 1073 */ | |
| 1074 public static const bool DEBUG = false; | |
| 1075 | |
| 1076 /** | |
| 1077 * Indicates that a chosen proposal should be inserted into the field. | |
| 1078 */ | |
| 1079 public static const int PROPOSAL_INSERT = 1; | |
| 1080 | |
| 1081 /** | |
| 1082 * Indicates that a chosen proposal should replace the entire contents of | |
| 1083 * the field. | |
| 1084 */ | |
| 1085 public static const int PROPOSAL_REPLACE = 2; | |
| 1086 | |
| 1087 /** | |
| 1088 * Indicates that the contents of the control should not be modified when a | |
| 1089 * proposal is chosen. This is typically used when a client needs more | |
| 1090 * specialized behavior when a proposal is chosen. In this case, clients | |
| 1091 * typically register an IContentProposalListener so that they are notified | |
| 1092 * when a proposal is chosen. | |
| 1093 */ | |
| 1094 public static const int PROPOSAL_IGNORE = 3; | |
| 1095 | |
| 1096 /** | |
| 1097 * Indicates that there should be no filter applied as keys are typed in the | |
| 1098 * popup. | |
| 1099 */ | |
| 1100 public static const int FILTER_NONE = 1; | |
| 1101 | |
| 1102 /** | |
| 1103 * Indicates that a single character filter applies as keys are typed in the | |
| 1104 * popup. | |
| 1105 */ | |
| 1106 public static const int FILTER_CHARACTER = 2; | |
| 1107 | |
| 1108 /** | |
| 1109 * Indicates that a cumulative filter applies as keys are typed in the | |
| 1110 * popup. That is, each character typed will be added to the filter. | |
| 71 | 1111 * |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1112 * @deprecated As of 3.4, filtering that is sensitive to changes in the |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1113 * control content should be performed by the supplied |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1114 * {@link IContentProposalProvider}, such as that performed by |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1115 * {@link SimpleContentProposalProvider} |
| 29 | 1116 */ |
| 1117 public static const int FILTER_CUMULATIVE = 3; | |
| 1118 | |
| 1119 /* | |
| 1120 * Set to <code>true</code> to use a Table with DWT.VIRTUAL. This is a | |
| 1121 * workaround for https://bugs.eclipse.org/bugs/show_bug.cgi?id=98585#c40 | |
| 1122 * The corresponding DWT bug is | |
| 1123 * https://bugs.eclipse.org/bugs/show_bug.cgi?id=90321 | |
| 1124 */ | |
| 1125 private static const bool USE_VIRTUAL = !"motif".equals(DWT.getPlatform()); //$NON-NLS-1$ | |
| 1126 | |
| 1127 /* | |
| 1128 * The delay before showing a secondary popup. | |
| 1129 */ | |
| 1130 private static const int POPUP_DELAY = 750; | |
| 1131 | |
| 1132 /* | |
| 1133 * The character height hint for the popup. May be overridden by using | |
| 1134 * setInitialPopupSize. | |
| 1135 */ | |
| 1136 private static const int POPUP_CHAR_HEIGHT = 10; | |
| 1137 | |
| 1138 /* | |
| 1139 * The minimum pixel width for the popup. May be overridden by using | |
| 1140 * setInitialPopupSize. | |
| 1141 */ | |
| 1142 private static const int POPUP_MINIMUM_WIDTH = 300; | |
| 1143 | |
| 1144 /* | |
| 1145 * The pixel offset of the popup from the bottom corner of the control. | |
| 1146 */ | |
| 1147 private static const int POPUP_OFFSET = 3; | |
| 1148 | |
| 1149 /* | |
| 1150 * Empty string. | |
| 1151 */ | |
| 1152 private static const String EMPTY = ""; //$NON-NLS-1$ | |
| 1153 | |
| 1154 /* | |
| 1155 * The object that provides content proposals. | |
| 1156 */ | |
| 1157 private IContentProposalProvider proposalProvider; | |
| 1158 | |
| 1159 /* | |
| 1160 * A label provider used to display proposals in the popup, and to extract | |
| 1161 * Strings from non-String proposals. | |
| 1162 */ | |
| 1163 private ILabelProvider labelProvider; | |
| 1164 | |
| 1165 /* | |
| 1166 * The control for which content proposals are provided. | |
| 1167 */ | |
| 1168 private Control control; | |
| 1169 | |
| 1170 /* | |
| 1171 * The adapter used to extract the String contents from an arbitrary | |
| 1172 * control. | |
| 1173 */ | |
| 1174 private IControlContentAdapter controlContentAdapter; | |
| 1175 | |
| 1176 /* | |
| 1177 * The popup used to show proposals. | |
| 1178 */ | |
| 1179 private ContentProposalPopup popup; | |
| 1180 | |
| 1181 /* | |
| 1182 * The keystroke that signifies content proposals should be shown. | |
| 1183 */ | |
| 1184 private KeyStroke triggerKeyStroke; | |
| 1185 | |
| 1186 /* | |
| 1187 * The String containing characters that auto-activate the popup. | |
| 1188 */ | |
| 1189 private String autoActivateString; | |
| 1190 | |
| 1191 /* | |
| 1192 * Integer that indicates how an accepted proposal should affect the | |
| 1193 * control. One of PROPOSAL_IGNORE, PROPOSAL_INSERT, or PROPOSAL_REPLACE. | |
| 1194 * Default value is PROPOSAL_INSERT. | |
| 1195 */ | |
| 1196 private int proposalAcceptanceStyle = PROPOSAL_INSERT; | |
| 1197 | |
| 1198 /* | |
| 1199 * A bool that indicates whether key events received while the proposal | |
| 1200 * popup is open should also be propagated to the control. Default value is | |
| 1201 * true. | |
| 1202 */ | |
| 1203 private bool propagateKeys = true; | |
| 1204 | |
| 1205 /* | |
| 1206 * Integer that indicates the filtering style. One of FILTER_CHARACTER, | |
| 1207 * FILTER_CUMULATIVE, FILTER_NONE. | |
| 1208 */ | |
| 1209 private int filterStyle = FILTER_NONE; | |
| 1210 | |
| 1211 /* | |
| 1212 * The listener we install on the control. | |
| 1213 */ | |
| 1214 private Listener controlListener; | |
| 1215 | |
| 1216 /* | |
| 1217 * The list of IContentProposalListener listeners. | |
| 1218 */ | |
| 1219 private ListenerList proposalListeners; | |
| 1220 | |
| 1221 /* | |
| 1222 * The list of IContentProposalListener2 listeners. | |
| 1223 */ | |
| 1224 private ListenerList proposalListeners2; | |
| 1225 | |
| 1226 /* | |
| 1227 * Flag that indicates whether the adapter is enabled. In some cases, | |
| 1228 * adapters may be installed but depend upon outside state. | |
| 1229 */ | |
| 1230 private bool isEnabled_ = true; | |
| 1231 | |
| 1232 /* | |
| 1233 * The delay in milliseconds used when autoactivating the popup. | |
| 1234 */ | |
| 1235 private int autoActivationDelay = 0; | |
| 1236 | |
| 1237 /* | |
| 1238 * A bool indicating whether a keystroke has been received. Used to see | |
| 1239 * if an autoactivation delay was interrupted by a keystroke. | |
| 1240 */ | |
| 1241 private bool receivedKeyDown; | |
| 1242 | |
| 1243 /* | |
| 1244 * The desired size in pixels of the proposal popup. | |
| 1245 */ | |
| 1246 private Point popupSize; | |
| 1247 | |
| 1248 /* | |
| 1249 * The remembered position of the insertion position. Not all controls will | |
| 1250 * restore the insertion position if the proposal popup gets focus, so we | |
| 1251 * need to remember it. | |
| 1252 */ | |
| 1253 private int insertionPos = -1; | |
| 1254 | |
| 1255 /* | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1256 * The remembered selection range. Not all controls will restore the |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1257 * selection position if the proposal popup gets focus, so we need to |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1258 * remember it. |
| 29 | 1259 */ |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1260 private Point selectionRange = new Point(-1, -1); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1261 |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1262 /* |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1263 * A flag that indicates that we are watching modify events |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1264 */ |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1265 private bool watchModify = false; |
| 29 | 1266 |
| 1267 /** | |
| 1268 * Construct a content proposal adapter that can assist the user with | |
| 1269 * choosing content for the field. | |
| 1270 * | |
| 1271 * @param control | |
| 1272 * the control for which the adapter is providing content assist. | |
| 1273 * May not be <code>null</code>. | |
| 1274 * @param controlContentAdapter | |
| 1275 * the <code>IControlContentAdapter</code> used to obtain and | |
| 1276 * update the control's contents as proposals are accepted. May | |
| 1277 * not be <code>null</code>. | |
| 1278 * @param proposalProvider | |
| 1279 * the <code>IContentProposalProvider</code> used to obtain | |
| 1280 * content proposals for this control, or <code>null</code> if | |
| 1281 * no content proposal is available. | |
| 1282 * @param keyStroke | |
| 1283 * the keystroke that will invoke the content proposal popup. If | |
| 1284 * this value is <code>null</code>, then proposals will be | |
| 1285 * activated automatically when any of the auto activation | |
| 1286 * characters are typed. | |
| 1287 * @param autoActivationCharacters | |
| 1288 * An array of characters that trigger auto-activation of content | |
| 1289 * proposal. If specified, these characters will trigger | |
| 1290 * auto-activation of the proposal popup, regardless of whether | |
| 1291 * an explicit invocation keyStroke was specified. If this | |
| 1292 * parameter is <code>null</code>, then only a specified | |
| 1293 * keyStroke will invoke content proposal. If this parameter is | |
| 1294 * <code>null</code> and the keyStroke parameter is | |
| 1295 * <code>null</code>, then all alphanumeric characters will | |
| 1296 * auto-activate content proposal. | |
| 1297 */ | |
| 1298 public this(Control control, | |
| 1299 IControlContentAdapter controlContentAdapter, | |
| 1300 IContentProposalProvider proposalProvider, KeyStroke keyStroke, | |
| 1301 char[] autoActivationCharacters) { | |
| 1302 proposalListeners = new ListenerList(); | |
| 1303 proposalListeners2 = new ListenerList(); | |
| 1304 //super(); | |
| 1305 // We always assume the control and content adapter are valid. | |
| 1306 Assert.isNotNull(cast(Object)control); | |
| 1307 Assert.isNotNull(cast(Object)controlContentAdapter); | |
| 1308 this.control = control; | |
| 1309 this.controlContentAdapter = controlContentAdapter; | |
| 1310 | |
| 1311 // The rest of these may be null | |
| 1312 this.proposalProvider = proposalProvider; | |
| 1313 this.triggerKeyStroke = keyStroke; | |
| 1314 if (autoActivationCharacters.length !is 0 ) { | |
| 1315 this.autoActivateString = autoActivationCharacters; | |
| 1316 } | |
| 1317 addControlListener(control); | |
| 1318 } | |
| 1319 | |
| 1320 /** | |
| 1321 * Get the control on which the content proposal adapter is installed. | |
| 1322 * | |
| 1323 * @return the control on which the proposal adapter is installed. | |
| 1324 */ | |
| 1325 public Control getControl() { | |
| 1326 return control; | |
| 1327 } | |
| 1328 | |
| 1329 /** | |
| 1330 * Get the label provider that is used to show proposals. | |
| 1331 * | |
| 1332 * @return the {@link ILabelProvider} used to show proposals, or | |
| 1333 * <code>null</code> if one has not been installed. | |
| 1334 */ | |
| 1335 public ILabelProvider getLabelProvider() { | |
| 1336 return labelProvider; | |
| 1337 } | |
| 1338 | |
| 1339 /** | |
| 1340 * Return a bool indicating whether the receiver is enabled. | |
| 1341 * | |
| 1342 * @return <code>true</code> if the adapter is enabled, and | |
| 1343 * <code>false</code> if it is not. | |
| 1344 */ | |
| 1345 public bool isEnabled() { | |
| 1346 return isEnabled_; | |
| 1347 } | |
| 1348 | |
| 1349 /** | |
| 1350 * Set the label provider that is used to show proposals. The lifecycle of | |
| 1351 * the specified label provider is not managed by this adapter. Clients must | |
| 1352 * dispose the label provider when it is no longer needed. | |
| 1353 * | |
| 1354 * @param labelProvider | |
| 1355 * the (@link ILabelProvider} used to show proposals. | |
| 1356 */ | |
| 1357 public void setLabelProvider(ILabelProvider labelProvider) { | |
| 1358 this.labelProvider = labelProvider; | |
| 1359 } | |
| 1360 | |
| 1361 /** | |
| 1362 * Return the proposal provider that provides content proposals given the | |
| 1363 * current content of the field. A value of <code>null</code> indicates | |
| 1364 * that there are no content proposals available for the field. | |
| 1365 * | |
| 1366 * @return the {@link IContentProposalProvider} used to show proposals. May | |
| 1367 * be <code>null</code>. | |
| 1368 */ | |
| 1369 public IContentProposalProvider getContentProposalProvider() { | |
| 1370 return proposalProvider; | |
| 1371 } | |
| 1372 | |
| 1373 /** | |
| 1374 * Set the content proposal provider that is used to show proposals. | |
| 1375 * | |
| 1376 * @param proposalProvider | |
| 1377 * the {@link IContentProposalProvider} used to show proposals | |
| 1378 */ | |
| 1379 public void setContentProposalProvider( | |
| 1380 IContentProposalProvider proposalProvider) { | |
| 1381 this.proposalProvider = proposalProvider; | |
| 1382 } | |
| 1383 | |
| 1384 /** | |
| 1385 * Return the array of characters on which the popup is autoactivated. | |
| 1386 * | |
| 1387 * @return An array of characters that trigger auto-activation of content | |
| 1388 * proposal. If specified, these characters will trigger | |
| 1389 * auto-activation of the proposal popup, regardless of whether an | |
| 1390 * explicit invocation keyStroke was specified. If this parameter is | |
| 1391 * <code>null</code>, then only a specified keyStroke will invoke | |
| 1392 * content proposal. If this value is <code>null</code> and the | |
| 1393 * keyStroke value is <code>null</code>, then all alphanumeric | |
| 1394 * characters will auto-activate content proposal. | |
| 1395 */ | |
| 1396 public char[] getAutoActivationCharacters() { | |
| 1397 if (autoActivateString is null) { | |
| 1398 return null; | |
| 1399 } | |
| 1400 return autoActivateString/+.toCharArray()+/; | |
| 1401 } | |
| 1402 | |
| 1403 /** | |
| 1404 * Set the array of characters that will trigger autoactivation of the | |
| 1405 * popup. | |
| 1406 * | |
| 1407 * @param autoActivationCharacters | |
| 1408 * An array of characters that trigger auto-activation of content | |
| 1409 * proposal. If specified, these characters will trigger | |
| 1410 * auto-activation of the proposal popup, regardless of whether | |
| 1411 * an explicit invocation keyStroke was specified. If this | |
| 1412 * parameter is <code>null</code>, then only a specified | |
| 1413 * keyStroke will invoke content proposal. If this parameter is | |
| 1414 * <code>null</code> and the keyStroke value is | |
| 1415 * <code>null</code>, then all alphanumeric characters will | |
| 1416 * auto-activate content proposal. | |
| 1417 * | |
| 1418 */ | |
| 1419 public void setAutoActivationCharacters(char[] autoActivationCharacters) { | |
| 1420 if (autoActivationCharacters.length is 0) { | |
| 1421 this.autoActivateString = null; | |
| 1422 } else { | |
| 1423 this.autoActivateString = autoActivationCharacters; | |
| 1424 } | |
| 1425 } | |
| 1426 | |
| 1427 /** | |
| 1428 * Set the delay, in milliseconds, used before any autoactivation is | |
| 1429 * triggered. | |
| 1430 * | |
| 1431 * @return the time in milliseconds that will pass before a popup is | |
| 1432 * automatically opened | |
| 1433 */ | |
| 1434 public int getAutoActivationDelay() { | |
| 1435 return autoActivationDelay; | |
| 1436 | |
| 1437 } | |
| 1438 | |
| 1439 /** | |
| 1440 * Set the delay, in milliseconds, used before autoactivation is triggered. | |
| 1441 * | |
| 1442 * @param delay | |
| 1443 * the time in milliseconds that will pass before a popup is | |
| 1444 * automatically opened | |
| 1445 */ | |
| 1446 public void setAutoActivationDelay(int delay) { | |
| 1447 autoActivationDelay = delay; | |
| 1448 | |
| 1449 } | |
| 1450 | |
| 1451 /** | |
| 1452 * Get the integer style that indicates how an accepted proposal affects the | |
| 1453 * control's content. | |
| 1454 * | |
| 1455 * @return a constant indicating how an accepted proposal should affect the | |
| 1456 * control's content. Should be one of <code>PROPOSAL_INSERT</code>, | |
| 1457 * <code>PROPOSAL_REPLACE</code>, or <code>PROPOSAL_IGNORE</code>. | |
| 1458 * (Default is <code>PROPOSAL_INSERT</code>). | |
| 1459 */ | |
| 1460 public int getProposalAcceptanceStyle() { | |
| 1461 return proposalAcceptanceStyle; | |
| 1462 } | |
| 1463 | |
| 1464 /** | |
| 1465 * Set the integer style that indicates how an accepted proposal affects the | |
| 1466 * control's content. | |
| 1467 * | |
| 1468 * @param acceptance | |
| 1469 * a constant indicating how an accepted proposal should affect | |
| 1470 * the control's content. Should be one of | |
| 1471 * <code>PROPOSAL_INSERT</code>, <code>PROPOSAL_REPLACE</code>, | |
| 1472 * or <code>PROPOSAL_IGNORE</code> | |
| 1473 */ | |
| 1474 public void setProposalAcceptanceStyle(int acceptance) { | |
| 1475 proposalAcceptanceStyle = acceptance; | |
| 1476 } | |
| 1477 | |
| 1478 /** | |
| 1479 * Return the integer style that indicates how keystrokes affect the content | |
| 1480 * of the proposal popup while it is open. | |
| 1481 * | |
| 1482 * @return a constant indicating how keystrokes in the proposal popup affect | |
| 1483 * filtering of the proposals shown. <code>FILTER_NONE</code> | |
| 1484 * specifies that no filtering will occur in the content proposal | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1485 * list as keys are typed. <code>FILTER_CHARACTER</code> specifies |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1486 * the content of the popup will be filtered by the most recently |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1487 * typed character. <code>FILTER_CUMULATIVE</code> is deprecated |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1488 * and no longer recommended. It specifies that the content of the |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1489 * popup will be filtered by a string containing all the characters |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1490 * typed since the popup has been open. The default is |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1491 * <code>FILTER_NONE</code>. |
| 29 | 1492 */ |
| 1493 public int getFilterStyle() { | |
| 1494 return filterStyle; | |
| 1495 } | |
| 1496 | |
| 1497 /** | |
| 1498 * Set the integer style that indicates how keystrokes affect the content of | |
| 1499 * the proposal popup while it is open. Popup-based filtering is useful for | |
| 1500 * narrowing and navigating the list of proposals provided once the popup is | |
| 1501 * open. Filtering of the proposals will occur even when the control content | |
| 1502 * is not affected by user typing. Note that automatic filtering is not used | |
| 1503 * to achieve content-sensitive filtering such as auto-completion. Filtering | |
| 1504 * that is sensitive to changes in the control content should be performed | |
| 1505 * by the supplied {@link IContentProposalProvider}. | |
| 1506 * | |
| 1507 * @param filterStyle | |
| 1508 * a constant indicating how keystrokes received in the proposal | |
| 1509 * popup affect filtering of the proposals shown. | |
| 1510 * <code>FILTER_NONE</code> specifies that no automatic | |
| 1511 * filtering of the content proposal list will occur as keys are | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1512 * typed in the popup. <code>FILTER_CHARACTER</code> specifies |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1513 * that the content of the popup will be filtered by the most |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1514 * recently typed character. <code>FILTER_CUMULATIVE</code> is |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1515 * deprecated and no longer recommended. It specifies that the |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1516 * content of the popup will be filtered by a string containing |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1517 * all the characters typed since the popup has been open. |
| 29 | 1518 */ |
| 1519 public void setFilterStyle(int filterStyle) { | |
| 1520 this.filterStyle = filterStyle; | |
| 1521 } | |
| 1522 | |
| 1523 /** | |
| 1524 * Return the size, in pixels, of the content proposal popup. | |
| 1525 * | |
| 1526 * @return a Point specifying the last width and height, in pixels, of the | |
| 1527 * content proposal popup. | |
| 1528 */ | |
| 1529 public Point getPopupSize() { | |
| 1530 return popupSize; | |
| 1531 } | |
| 1532 | |
| 1533 /** | |
| 1534 * Set the size, in pixels, of the content proposal popup. This size will be | |
| 1535 * used the next time the content proposal popup is opened. | |
| 1536 * | |
| 1537 * @param size | |
| 1538 * a Point specifying the desired width and height, in pixels, of | |
| 1539 * the content proposal popup. | |
| 1540 */ | |
| 1541 public void setPopupSize(Point size) { | |
| 1542 popupSize = size; | |
| 1543 } | |
| 1544 | |
| 1545 /** | |
| 1546 * Get the bool that indicates whether key events (including | |
| 1547 * auto-activation characters) received by the content proposal popup should | |
| 1548 * also be propagated to the adapted control when the proposal popup is | |
| 1549 * open. | |
| 1550 * | |
| 1551 * @return a bool that indicates whether key events (including | |
| 1552 * auto-activation characters) should be propagated to the adapted | |
| 1553 * control when the proposal popup is open. Default value is | |
| 1554 * <code>true</code>. | |
| 1555 */ | |
| 1556 public bool getPropagateKeys() { | |
| 1557 return propagateKeys; | |
| 1558 } | |
| 1559 | |
| 1560 /** | |
| 1561 * Set the bool that indicates whether key events (including | |
| 1562 * auto-activation characters) received by the content proposal popup should | |
| 1563 * also be propagated to the adapted control when the proposal popup is | |
| 1564 * open. | |
| 1565 * | |
| 1566 * @param propagateKeys | |
| 1567 * a bool that indicates whether key events (including | |
| 1568 * auto-activation characters) should be propagated to the | |
| 1569 * adapted control when the proposal popup is open. | |
| 1570 */ | |
| 1571 public void setPropagateKeys(bool propagateKeys) { | |
| 1572 this.propagateKeys = propagateKeys; | |
| 1573 } | |
| 1574 | |
| 1575 /** | |
| 1576 * Return the content adapter that can get or retrieve the text contents | |
| 1577 * from the adapter's control. This method is used when a client, such as a | |
| 1578 * content proposal listener, needs to update the control's contents | |
| 1579 * manually. | |
| 1580 * | |
| 1581 * @return the {@link IControlContentAdapter} which can update the control | |
| 1582 * text. | |
| 1583 */ | |
| 1584 public IControlContentAdapter getControlContentAdapter() { | |
| 1585 return controlContentAdapter; | |
| 1586 } | |
| 1587 | |
| 1588 /** | |
| 1589 * Set the bool flag that determines whether the adapter is enabled. | |
| 1590 * | |
| 1591 * @param enabled | |
| 1592 * <code>true</code> if the adapter is enabled and responding | |
| 1593 * to user input, <code>false</code> if it is ignoring user | |
| 1594 * input. | |
| 1595 * | |
| 1596 */ | |
| 1597 public void setEnabled(bool enabled) { | |
| 1598 // If we are disabling it while it's proposing content, close the | |
| 1599 // content proposal popup. | |
| 1600 if (isEnabled_ && !enabled) { | |
| 1601 if (popup !is null) { | |
| 1602 popup.close(); | |
| 1603 } | |
| 1604 } | |
| 1605 isEnabled_ = enabled; | |
| 1606 } | |
| 1607 | |
| 1608 /** | |
| 1609 * Add the specified listener to the list of content proposal listeners that | |
| 1610 * are notified when content proposals are chosen. | |
| 1611 * </p> | |
| 1612 * | |
| 1613 * @param listener | |
| 1614 * the IContentProposalListener to be added as a listener. Must | |
| 1615 * not be <code>null</code>. If an attempt is made to register | |
| 1616 * an instance which is already registered with this instance, | |
| 1617 * this method has no effect. | |
| 1618 * | |
| 1619 * @see dwtx.jface.fieldassist.IContentProposalListener | |
| 1620 */ | |
| 1621 public void addContentProposalListener(IContentProposalListener listener) { | |
| 1622 proposalListeners.add(cast(Object)listener); | |
| 1623 } | |
| 1624 | |
| 1625 /** | |
| 1626 * Removes the specified listener from the list of content proposal | |
| 1627 * listeners that are notified when content proposals are chosen. | |
| 1628 * </p> | |
| 1629 * | |
| 1630 * @param listener | |
| 1631 * the IContentProposalListener to be removed as a listener. Must | |
| 1632 * not be <code>null</code>. If the listener has not already | |
| 1633 * been registered, this method has no effect. | |
| 1634 * | |
| 1635 * @since 3.3 | |
| 1636 * @see dwtx.jface.fieldassist.IContentProposalListener | |
| 1637 */ | |
| 1638 public void removeContentProposalListener(IContentProposalListener listener) { | |
| 1639 proposalListeners.remove(cast(Object)listener); | |
| 1640 } | |
| 1641 | |
| 1642 /** | |
| 1643 * Add the specified listener to the list of content proposal listeners that | |
| 1644 * are notified when a content proposal popup is opened or closed. | |
| 1645 * </p> | |
| 1646 * | |
| 1647 * @param listener | |
| 1648 * the IContentProposalListener2 to be added as a listener. Must | |
| 1649 * not be <code>null</code>. If an attempt is made to register | |
| 1650 * an instance which is already registered with this instance, | |
| 1651 * this method has no effect. | |
| 1652 * | |
| 1653 * @since 3.3 | |
| 1654 * @see dwtx.jface.fieldassist.IContentProposalListener2 | |
| 1655 */ | |
| 1656 public void addContentProposalListener(IContentProposalListener2 listener) { | |
| 1657 proposalListeners2.add(cast(Object)listener); | |
| 1658 } | |
| 1659 | |
| 1660 /** | |
| 1661 * Remove the specified listener from the list of content proposal listeners | |
| 1662 * that are notified when a content proposal popup is opened or closed. | |
| 1663 * </p> | |
| 1664 * | |
| 1665 * @param listener | |
| 1666 * the IContentProposalListener2 to be removed as a listener. | |
| 1667 * Must not be <code>null</code>. If the listener has not | |
| 1668 * already been registered, this method has no effect. | |
| 1669 * | |
| 1670 * @since 3.3 | |
| 1671 * @see dwtx.jface.fieldassist.IContentProposalListener2 | |
| 1672 */ | |
| 1673 public void removeContentProposalListener(IContentProposalListener2 listener) { | |
| 1674 proposalListeners2.remove(cast(Object)listener); | |
| 1675 } | |
| 1676 | |
| 1677 /* | |
| 1678 * Add our listener to the control. Debug information to be left in until | |
| 1679 * this support is stable on all platforms. | |
| 1680 */ | |
| 1681 private void addControlListener(Control control) { | |
| 1682 if (DEBUG) { | |
| 1683 Stdout.formatln("ContentProposalListener#installControlListener()"); //$NON-NLS-1$ | |
| 1684 } | |
| 1685 | |
| 1686 if (controlListener !is null) { | |
| 1687 return; | |
| 1688 } | |
| 1689 controlListener = new class Listener { | |
| 1690 public void handleEvent(Event e) { | |
| 1691 if (!isEnabled_) { | |
| 1692 return; | |
| 1693 } | |
| 1694 | |
| 1695 switch (e.type) { | |
| 1696 case DWT.Traverse: | |
| 1697 case DWT.KeyDown: | |
| 1698 if (DEBUG) { | |
| 1699 StringBuffer sb; | |
| 1700 if (e.type is DWT.Traverse) { | |
| 1701 sb = new StringBuffer("Traverse"); //$NON-NLS-1$ | |
| 1702 } else { | |
| 1703 sb = new StringBuffer("KeyDown"); //$NON-NLS-1$ | |
| 1704 } | |
| 1705 sb.append(" received by adapter"); //$NON-NLS-1$ | |
| 1706 dump(sb.toString(), e); | |
| 1707 } | |
| 1708 // If the popup is open, it gets first shot at the | |
| 1709 // keystroke and should set the doit flags appropriately. | |
| 1710 if (popup !is null) { | |
| 1711 popup.getTargetControlListener().handleEvent(e); | |
| 1712 if (DEBUG) { | |
| 1713 StringBuffer sb; | |
| 1714 if (e.type is DWT.Traverse) { | |
| 1715 sb = new StringBuffer("Traverse"); //$NON-NLS-1$ | |
| 1716 } else { | |
| 1717 sb = new StringBuffer("KeyDown"); //$NON-NLS-1$ | |
| 1718 } | |
| 1719 sb.append(" after being handled by popup"); //$NON-NLS-1$ | |
| 1720 dump(sb.toString(), e); | |
| 1721 } | |
| 1722 | |
| 1723 return; | |
| 1724 } | |
| 1725 | |
| 1726 // We were only listening to traverse events for the popup | |
| 1727 if (e.type is DWT.Traverse) { | |
| 1728 return; | |
| 1729 } | |
| 1730 | |
| 1731 // The popup is not open. We are looking at keydown events | |
| 1732 // for a trigger to open the popup. | |
| 1733 if (triggerKeyStroke !is null) { | |
| 1734 // Either there are no modifiers for the trigger and we | |
| 1735 // check the character field... | |
| 1736 if ((triggerKeyStroke.getModifierKeys() is KeyStroke.NO_KEY && triggerKeyStroke | |
| 1737 .getNaturalKey() is e.character) | |
| 1738 || | |
| 1739 // ...or there are modifiers, in which case the | |
| 1740 // keycode and state must match | |
| 1741 (triggerKeyStroke.getNaturalKey() is e.keyCode && ((triggerKeyStroke | |
| 1742 .getModifierKeys() & e.stateMask) is triggerKeyStroke | |
| 1743 .getModifierKeys()))) { | |
| 1744 // We never propagate the keystroke for an explicit | |
| 1745 // keystroke invocation of the popup | |
| 1746 e.doit = false; | |
| 1747 openProposalPopup(false); | |
| 1748 return; | |
| 1749 } | |
| 1750 } | |
| 1751 /* | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1752 * The triggering keystroke was not invoked. If a character |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1753 * was typed, compare it to the autoactivation characters. |
| 29 | 1754 */ |
| 1755 if (e.character !is 0) { | |
| 1756 if (autoActivateString !is null) { | |
| 1757 if (autoActivateString.indexOf(e.character) >= 0) { | |
| 1758 autoActivate(); | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1759 } else { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1760 // No autoactivation occurred, so record the key |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1761 // down as a means to interrupt any |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1762 // autoactivation |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1763 // that is pending due to autoactivation delay. |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1764 receivedKeyDown = true; |
| 29 | 1765 } |
| 1766 } else { | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1767 // The autoactivate string is null. If the trigger |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1768 // is also null, we want to act on any modification |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1769 // to the content. Set a flag so we'll catch this |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1770 // in the modify event. |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1771 if (triggerKeyStroke is null) { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1772 watchModify = true; |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1773 } |
| 29 | 1774 } |
| 1775 } | |
| 1776 break; | |
| 1777 | |
| 1778 // See https://bugs.eclipse.org/bugs/show_bug.cgi?id=147377 | |
| 1779 // Given that we will close the popup when there are no valid | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1780 // proposals, we must reopen it when there are. This means |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1781 // we should check modifications in those cases. |
| 29 | 1782 // See also https://bugs.eclipse.org/bugs/show_bug.cgi?id=183650 |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1783 // The watchModify flag ensures that we don't autoactivate if |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1784 // the content change was caused by something other than typing. |
| 29 | 1785 case DWT.Modify: |
| 1786 if (triggerKeyStroke is null && autoActivateString is null | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1787 && watchModify) { |
| 29 | 1788 if (DEBUG) { |
| 1789 dump("Modify event triggers autoactivation", e); //$NON-NLS-1$ | |
| 1790 } | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1791 watchModify = false; |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1792 // We don't autoactivate if the net change is no |
| 71 | 1793 // content. In other words, backspacing to empty |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1794 // should never cause a popup to open. |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1795 if (!isControlContentEmpty()) { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1796 autoActivate(); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1797 } |
| 29 | 1798 } |
| 1799 break; | |
| 1800 default: | |
| 1801 break; | |
| 1802 } | |
| 1803 } | |
| 1804 | |
| 1805 /** | |
| 1806 * Dump the given events to "standard" output. | |
| 1807 * | |
| 1808 * @param who | |
| 1809 * who is dumping the event | |
| 1810 * @param e | |
| 1811 * the event | |
| 1812 */ | |
| 1813 private void dump(String who, Event e) { | |
| 1814 StringBuffer sb = new StringBuffer( | |
| 1815 "--- [ContentProposalAdapter]\n"); //$NON-NLS-1$ | |
| 1816 sb.append(who); | |
| 1817 sb.append(Format(" - e: keyCode={}{}", e.keyCode, hex(e.keyCode))); //$NON-NLS-1$ | |
| 1818 sb.append(Format("; character={}{}", e.character, hex(e.character))); //$NON-NLS-1$ | |
| 1819 sb.append(Format("; stateMask={}{}", e.stateMask, hex(e.stateMask))); //$NON-NLS-1$ | |
| 1820 sb.append(Format("; doit={}", e.doit)); //$NON-NLS-1$ | |
| 1821 sb.append(Format("; detail={}", e.detail, hex(e.detail))); //$NON-NLS-1$ | |
| 1822 sb.append(Format("; widget={}", e.widget)); //$NON-NLS-1$ | |
| 1823 Stdout.formatln("{}",sb.toString); | |
| 1824 } | |
| 1825 | |
| 1826 private String hex(int i) { | |
| 1827 return Format("[0x{:X}]", i); //$NON-NLS-1$ | |
| 1828 } | |
| 1829 }; | |
| 1830 control.addListener(DWT.KeyDown, controlListener); | |
| 1831 control.addListener(DWT.Traverse, controlListener); | |
| 1832 control.addListener(DWT.Modify, controlListener); | |
| 1833 | |
| 1834 if (DEBUG) { | |
| 1835 Stdout.formatln("ContentProposalAdapter#installControlListener() - installed"); //$NON-NLS-1$ | |
| 1836 } | |
| 1837 } | |
| 1838 | |
| 1839 /** | |
| 1840 * Open the proposal popup and display the proposals provided by the | |
| 1841 * proposal provider. If there are no proposals to be shown, do not show the | |
| 1842 * popup. This method returns immediately. That is, it does not wait for the | |
| 1843 * popup to open or a proposal to be selected. | |
| 1844 * | |
| 1845 * @param autoActivated | |
| 1846 * a bool indicating whether the popup was autoactivated. If | |
| 1847 * false, a beep will sound when no proposals can be shown. | |
| 1848 */ | |
| 1849 private void openProposalPopup(bool autoActivated) { | |
| 1850 if (isValid()) { | |
| 1851 if (popup is null) { | |
| 1852 // Check whether there are any proposals to be shown. | |
| 1853 recordCursorPosition(); // must be done before getting proposals | |
| 1854 IContentProposal[] proposals = getProposals(); | |
| 1855 if (proposals.length > 0) { | |
| 1856 if (DEBUG) { | |
| 1857 Stdout.formatln("POPUP OPENED BY PRECEDING EVENT"); //$NON-NLS-1$ | |
| 1858 } | |
| 1859 recordCursorPosition(); | |
| 1860 popup = new ContentProposalPopup(null, proposals); | |
| 1861 popup.open(); | |
| 1862 popup.getShell().addDisposeListener(new class DisposeListener { | |
| 1863 public void widgetDisposed(DisposeEvent event) { | |
| 1864 popup = null; | |
| 1865 } | |
| 1866 }); | |
| 1867 notifyPopupOpened(); | |
| 1868 } else if (!autoActivated) { | |
| 1869 getControl().getDisplay().beep(); | |
| 1870 } | |
| 1871 } | |
| 1872 } | |
| 1873 } | |
| 1874 | |
| 1875 /** | |
| 1876 * Open the proposal popup and display the proposals provided by the | |
| 1877 * proposal provider. This method returns immediately. That is, it does not | |
| 1878 * wait for a proposal to be selected. This method is used by subclasses to | |
| 1879 * explicitly invoke the opening of the popup. If there are no proposals to | |
| 1880 * show, the popup will not open and a beep will be sounded. | |
| 1881 */ | |
| 1882 protected void openProposalPopup() { | |
| 1883 openProposalPopup(false); | |
| 1884 } | |
| 1885 | |
| 1886 /** | |
| 1887 * Close the proposal popup without accepting a proposal. This method | |
| 1888 * returns immediately, and has no effect if the proposal popup was not | |
| 1889 * open. This method is used by subclasses to explicitly close the popup | |
| 1890 * based on additional logic. | |
| 1891 * | |
| 1892 * @since 3.3 | |
| 1893 */ | |
| 1894 protected void closeProposalPopup() { | |
| 1895 if (popup !is null) { | |
| 1896 popup.close(); | |
| 1897 } | |
| 1898 } | |
| 1899 | |
| 1900 /* | |
| 1901 * A content proposal has been accepted. Update the control contents | |
| 1902 * accordingly and notify any listeners. | |
| 1903 * | |
| 1904 * @param proposal the accepted proposal | |
| 1905 */ | |
| 1906 private void proposalAccepted(IContentProposal proposal) { | |
| 1907 switch (proposalAcceptanceStyle) { | |
| 1908 case (PROPOSAL_REPLACE): | |
| 1909 setControlContent(proposal.getContent(), proposal | |
| 1910 .getCursorPosition()); | |
| 1911 break; | |
| 1912 case (PROPOSAL_INSERT): | |
| 1913 insertControlContent(proposal.getContent(), proposal | |
| 1914 .getCursorPosition()); | |
| 1915 break; | |
| 1916 default: | |
| 1917 // do nothing. Typically a listener is installed to handle this in | |
| 1918 // a custom way. | |
| 1919 break; | |
| 1920 } | |
| 1921 | |
| 1922 // In all cases, notify listeners of an accepted proposal. | |
| 1923 notifyProposalAccepted(proposal); | |
| 1924 } | |
| 1925 | |
| 1926 /* | |
| 1927 * Set the text content of the control to the specified text, setting the | |
| 1928 * cursorPosition at the desired location within the new contents. | |
| 1929 */ | |
| 1930 private void setControlContent(String text, int cursorPosition) { | |
| 1931 if (isValid()) { | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1932 // should already be false, but just in case. |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1933 watchModify = false; |
| 29 | 1934 controlContentAdapter.setControlContents(control, text, |
| 1935 cursorPosition); | |
| 1936 } | |
| 1937 } | |
| 1938 | |
| 1939 /* | |
| 1940 * Insert the specified text into the control content, setting the | |
| 1941 * cursorPosition at the desired location within the new contents. | |
| 1942 */ | |
| 1943 private void insertControlContent(String text, int cursorPosition) { | |
| 1944 if (isValid()) { | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1945 // should already be false, but just in case. |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1946 watchModify = false; |
| 29 | 1947 // Not all controls preserve their selection index when they lose |
| 1948 // focus, so we must set it explicitly here to what it was before | |
| 1949 // the popup opened. | |
| 1950 // See https://bugs.eclipse.org/bugs/show_bug.cgi?id=127108 | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1951 // See https://bugs.eclipse.org/bugs/show_bug.cgi?id=139063 |
| 71 | 1952 if (null !is cast(IControlContentAdapter2)controlContentAdapter |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1953 && selectionRange.x !is -1) { |
| 71 | 1954 (cast(IControlContentAdapter2) controlContentAdapter).setSelection( |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1955 control, selectionRange); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1956 } else if (insertionPos !is -1) { |
| 29 | 1957 controlContentAdapter.setCursorPosition(control, insertionPos); |
| 1958 } | |
| 1959 controlContentAdapter.insertControlContents(control, text, | |
| 1960 cursorPosition); | |
| 1961 } | |
| 1962 } | |
| 1963 | |
| 1964 /* | |
| 1965 * Check that the control and content adapter are valid. | |
| 1966 */ | |
| 1967 private bool isValid() { | |
| 1968 return control !is null && !control.isDisposed() | |
| 1969 && controlContentAdapter !is null; | |
| 1970 } | |
| 1971 | |
| 1972 /* | |
| 1973 * Record the control's cursor position. | |
| 1974 */ | |
| 1975 private void recordCursorPosition() { | |
| 1976 if (isValid()) { | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1977 IControlContentAdapter adapter = getControlContentAdapter(); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1978 insertionPos = adapter.getCursorPosition(control); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1979 // see https://bugs.eclipse.org/bugs/show_bug.cgi?id=139063 |
| 71 | 1980 if (null !is cast(IControlContentAdapter2)adapter ) { |
| 1981 selectionRange = (cast(IControlContentAdapter2) adapter) | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1982 .getSelection(control); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
1983 } |
| 29 | 1984 |
| 1985 } | |
| 1986 } | |
| 1987 | |
| 1988 /* | |
| 1989 * Get the proposals from the proposal provider. Gets all of the proposals | |
| 1990 * without doing any filtering. | |
| 1991 */ | |
| 1992 private IContentProposal[] getProposals() { | |
| 1993 if (proposalProvider is null || !isValid()) { | |
| 1994 return null; | |
| 1995 } | |
| 1996 if (DEBUG) { | |
| 1997 Stdout.formatln(">>> obtaining proposals from provider"); //$NON-NLS-1$ | |
| 1998 } | |
| 1999 int position = insertionPos; | |
| 2000 if (position is -1) { | |
| 2001 position = getControlContentAdapter().getCursorPosition( | |
| 2002 getControl()); | |
| 2003 } | |
| 2004 String contents = getControlContentAdapter().getControlContents( | |
| 2005 getControl()); | |
| 2006 IContentProposal[] proposals = proposalProvider.getProposals(contents, | |
| 2007 position); | |
| 2008 return proposals; | |
| 2009 } | |
| 2010 | |
| 2011 /** | |
| 2012 * Autoactivation has been triggered. Open the popup using any specified | |
| 2013 * delay. | |
| 2014 */ | |
| 2015 private void autoActivate() { | |
| 2016 if (autoActivationDelay > 0) { | |
| 2017 auto r = new class Runnable{ | |
| 2018 public void run(){ | |
| 2019 receivedKeyDown = false; | |
| 2020 try { | |
| 2021 Thread.sleep(autoActivationDelay); | |
| 2022 } catch (InterruptedException e) { | |
| 2023 } | |
| 2024 if (!isValid() || receivedKeyDown) { | |
| 2025 return; | |
| 2026 } | |
| 2027 getControl().getDisplay().syncExec(new class Runnable { | |
| 2028 public void run() { | |
| 2029 openProposalPopup(true); | |
| 2030 } | |
| 2031 }); | |
| 2032 } | |
| 2033 }; | |
| 2034 Thread t = new Thread(&r.run); | |
| 2035 t.start(); | |
| 2036 } else { | |
| 2037 // Since we do not sleep, we must open the popup | |
| 2038 // in an async exec. This is necessary because | |
| 2039 // this method may be called in the middle of handling | |
| 2040 // some event that will cause the cursor position or | |
| 2041 // other important info to change as a result of this | |
| 2042 // event occurring. | |
| 2043 getControl().getDisplay().asyncExec(new class Runnable { | |
| 2044 public void run() { | |
| 2045 if (isValid()) { | |
| 2046 openProposalPopup(true); | |
| 2047 } | |
| 2048 } | |
| 2049 }); | |
| 2050 } | |
| 2051 } | |
| 2052 | |
| 2053 /* | |
| 2054 * A proposal has been accepted. Notify interested listeners. | |
| 2055 */ | |
| 2056 private void notifyProposalAccepted(IContentProposal proposal) { | |
| 2057 if (DEBUG) { | |
| 2058 Stdout.formatln("Notify listeners - proposal accepted."); //$NON-NLS-1$ | |
| 2059 } | |
| 2060 Object[] listenerArray = proposalListeners.getListeners(); | |
| 2061 for (int i = 0; i < listenerArray.length; i++) { | |
| 2062 (cast(IContentProposalListener) listenerArray[i]) | |
| 2063 .proposalAccepted(proposal); | |
| 2064 } | |
| 2065 } | |
| 2066 | |
| 2067 /* | |
| 2068 * The proposal popup has opened. Notify interested listeners. | |
| 2069 */ | |
| 2070 private void notifyPopupOpened() { | |
| 2071 if (DEBUG) { | |
| 2072 Stdout.formatln("Notify listeners - popup opened."); //$NON-NLS-1$ | |
| 2073 } | |
| 2074 Object[] listenerArray = proposalListeners2.getListeners(); | |
| 2075 for (int i = 0; i < listenerArray.length; i++) { | |
| 2076 (cast(IContentProposalListener2) listenerArray[i]) | |
| 2077 .proposalPopupOpened(this); | |
| 2078 } | |
| 2079 } | |
| 2080 | |
| 2081 /* | |
| 2082 * The proposal popup has closed. Notify interested listeners. | |
| 2083 */ | |
| 2084 private void notifyPopupClosed() { | |
| 2085 if (DEBUG) { | |
| 2086 Stdout.formatln("Notify listeners - popup closed."); //$NON-NLS-1$ | |
| 2087 } | |
| 2088 Object[] listenerArray = proposalListeners2.getListeners(); | |
| 2089 for (int i = 0; i < listenerArray.length; i++) { | |
| 2090 (cast(IContentProposalListener2) listenerArray[i]) | |
| 2091 .proposalPopupClosed(this); | |
| 2092 } | |
| 2093 } | |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2094 |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2095 /** |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2096 * Returns whether the content proposal popup has the focus. This includes |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2097 * both the primary popup and any secondary info popup that may have focus. |
| 71 | 2098 * |
|
70
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2099 * @return <code>true</code> if the proposal popup or its secondary info |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2100 * popup has the focus |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2101 * @since 3.4 |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2102 */ |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2103 public bool hasProposalPopupFocus() { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2104 return popup !is null && popup.hasFocus(); |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2105 } |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2106 |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2107 /* |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2108 * Return whether the control content is empty |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2109 */ |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2110 private bool isControlContentEmpty() { |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2111 return getControlContentAdapter().getControlContents(getControl()) |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2112 .length() is 0; |
|
46a6e0e6ccd4
Merge with d-fied sources of 3.4M7
Frank Benoit <benoit@tionex.de>
parents:
43
diff
changeset
|
2113 } |
| 29 | 2114 } |