changeset 1113:8d71632fa551

[DOC ONLY] Fix to ComboBox javadoc based on OTN forum thread highlighting inconsistencies (due to API changes late in the 2.1 development cycle). The OTN thread can be found here: https://forums.oracle.com/forums/thread.jspa?messageID=10327985#10327985
author jgiles
date Tue, 22 May 2012 11:00:25 +1200
parents 3ddd1460a76e
children ae1d114a26e3
files javafx-ui-controls/src/javafx/scene/control/ComboBox.java
diffstat 1 files changed, 6 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/javafx-ui-controls/src/javafx/scene/control/ComboBox.java	Tue May 22 10:55:45 2012 +1200
+++ b/javafx-ui-controls/src/javafx/scene/control/ComboBox.java	Tue May 22 11:00:25 2012 +1200
@@ -64,11 +64,12 @@
  * exceedingly long.
  * 
  * <p>As with ListView, it is possible to modify the 
- * {@link javafx.scene.control.SelectionModel SelectionModel} that is used, 
- * although this is likely to be rarely changed. The default
- * SelectionModel used in ComboBox is a {@link SingleSelectionModel}, but this
- * can be switched out by developers to instead allow for multiple selection to 
- * occur, or to alter the behavior of the various methods provided in these APIs.
+ * {@link javafx.scene.control.SelectionModel selection model} that is used, 
+ * although this is likely to be rarely changed. This is because the ComboBox
+ * enforces the need for a {@link javafx.scene.control.SingleSelectionModel} 
+ * instance, and it is not likely that there is much need for alternate 
+ * implementations. Nonetheless, the option is there should use cases be found 
+ * for switching the selection model.
  * 
  * <p>As the ComboBox internally renders content with a ListView, API exists in
  * the ComboBox class to allow for a custom cell factory to be set. For more