Spec-Zone .ru
спецификации, руководства, описания, API
|
public class ComboBox<T> extends ComboBoxBase<T>
ComboBoxBase
абстрактный class для наиболее распространенной формы ComboBox, где раскрывающийся список показывают пользователям, если их с выбором, из которого они могут выбрать. Для получения дополнительной информации вокруг общих понятий и API ComboBox, обратитесь к ComboBoxBase
Документация class. Вдобавок к ComboBoxBase ComboBox class представляет дополнительный API. Что наиболее важно это добавляет items
свойство, которое работает почти таким же способом ListView items
свойство. Другими словами это - контент списка элементов, который выводится на экран пользователям, когда они щелкают по кнопке ComboBox.
По умолчанию, когда раскрывающийся список показывает, максимальное количество видимых строк 10, но это может быть изменено, изменяя visibleRowCount
свойство. Если число элементов в ComboBox является меньше чем значение visibleRowCount
, тогда размер элементов будет использоваться вместо этого так, чтобы раскрывающийся список не был чрезвычайно длинен.
Как с ListView, возможно изменить selection model
это используется, хотя это, вероятно, будет редко изменяться. Это - то, потому что ComboBox осуществляет потребность в a SingleSelectionModel
экземпляр, и маловероятно, что есть много потребности в альтернативных реализациях. Тем не менее, опция, там должен варианты использования быть найденным для того, чтобы переключить модель выбора.
Поскольку ComboBox внутренне представляет контент с ListView, API существует в ComboBox class, чтобы учесть пользовательскую фабрику ячейки, которая будет установлена. Для получения дополнительной информации по фабрикам ячейки обратитесь к Cell
и ListCell
классы. Важно отметить, что, если фабрика ячейки устанавливается на ComboBox, ячейки будут только использоваться в ListView, который показывает, когда по ComboBox щелкают. Если Вы также хотите настроить рендеринг области 'кнопки' ComboBox, можно установить пользовательское ListCell
экземпляр в button cell
свойство. Один способ сделать это со следующим кодом (отметьте использование setButtonCell
:
Callback<ListView<String>, ListCell<String>> cellFactory = ...;
ComboBox comboBox = new ComboBox();
comboBox.setItems(items);
comboBox.setButtonCell(cellFactory.call(null));
comboBox.setCellFactory(cellFactory);
Поскольку ComboBox может быть editable
, и средство значения по умолчанию разрешения ввода данных пользователем через a TextField
, a string converter
свойство обеспечивается, чтобы учесть разработчиков, чтобы определить, как преобразовать пользовательскую строку в объект типа T, так, что value
свойство может содержать это. По умолчанию преобразователь просто возвращает Строковый ввод как пользователя, введенного это, которое поэтому предполагает, что тип доступного для редактирования ComboBox является Строкой. Если различный тип определяется, и ComboBox должен быть доступным для редактирования, необходимо определить пользовательское StringConverter
.
Node
экземпляры. Помещение узлов в список элементов строго не рекомендуется. Это то, потому что значение по умолчанию cell factory
просто вставляет элементы Узла непосредственно в ячейку, включая в области 'кнопки' ComboBox также. Поскольку scenegraph только учитывает Узлы, чтобы быть в одном месте за один раз, это означает, что, когда элемент выбирается, это становится удаленным из списка ComboBox, и становится видимым в области кнопки. Когда выбор изменяется ранее, выбранный пункт возвращается к списку, и новый выбор удаляется. Рекомендуемый подход, вместо того, чтобы вставить экземпляры Узла в список элементов, должен поместить релевантную информацию в ComboBox, и затем обеспечить пользовательское cell factory
. Например, вместо того, чтобы использовать следующий код:
ComboBox<Rectangle> cmb = new ComboBox<Rectangle>();
cmb.getItems().addAll(
new Rectangle(10, 10, Color.RED),
new Rectangle(10, 10, Color.GREEN),
new Rectangle(10, 10, Color.BLUE));
Следует сделать следующее:
ComboBox<Color> cmb = new ComboBox<Color>();
cmb.getItems().addAll(
Color.RED,
Color.GREEN,
Color.BLUE);
cmb.setCellFactory(new Callback<ListView<Color>, ListCell<Color>>() {
@Override public ListCell<Color> call(ListView<Color> p) {
return new ListCell<Color>() {
private final Rectangle rectangle;
{
setContentDisplay(ContentDisplay.GRAPHIC_ONLY);
rectangle = new Rectangle(10, 10);
}
@Override protected void updateItem(Color item, boolean empty) {
super.updateItem(item, empty);
if (item == null || empty) {
setGraphic(null);
} else {
rectangle.setFill(item);
setGraphic(rectangle);
}
}
};
}
});
По общему признанию вышеупомянутый подход гораздо более многословен, но он предлагает необходимую функциональность, не встречаясь с scenegraph ограничениями.
ComboBoxBase
, Cell
, ListCell
, StringConverter
Ввести | Свойство и Описание |
---|---|
ObjectProperty<ListCell<T>> |
buttonCell
Ячейка кнопки используется, чтобы представить то, что показывают в области 'кнопки' ComboBox.
|
ObjectProperty<Callback<ListView<T>,ListCell<T>>> |
cellFactory
Обеспечение пользовательской фабрики ячейки учитывает полную настройку рендеринга элементов в ComboBox.
|
ObjectProperty<StringConverter<T>> |
преобразователь
|
ReadOnlyObjectProperty<TextField> |
редактор
Редактор для ComboBox.
|
ObjectProperty<ObservableList<T>> |
элементы
Список элементов, чтобы показать в пределах раскрывающегося ComboBox.
|
ObjectProperty<SingleSelectionModel<T>> |
selectionModel
Модель выбора для ComboBox.
|
IntegerProperty |
visibleRowCount
Максимальное количество строк, чтобы быть видимым в ComboBox, раскрывающемся, когда это показывает.
|
armed, editable, onAction, onHidden, onHiding, onShowing, onShown, promptText, showing, value
contextMenu, height, maxHeight, maxWidth, minHeight, minWidth, prefHeight, prefWidth, skinClassName, skin, tooltip, width
needsLayout
blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, visible
ON_HIDDEN, ON_HIDING, ON_SHOWING, ON_SHOWN
USE_COMPUTED_SIZE, USE_PREF_SIZE
Конструктор и Описание |
---|
ComboBox()
Создает значение по умолчанию экземпляр ComboBox с пустым
items список и значение по умолчанию selection model . |
ComboBox(ObservableList<T> items)
Создает значение по умолчанию экземпляр ComboBox с обеспеченным списком элементов и значением по умолчанию
selection model . |
Модификатор и Тип | Метод и Описание |
---|---|
ObjectProperty<ListCell<T>> |
buttonCellProperty()
Ячейка кнопки используется, чтобы представить то, что показывают в области 'кнопки' ComboBox.
|
ObjectProperty<Callback<ListView<T>,ListCell<T>>> |
cellFactoryProperty()
Обеспечение пользовательской фабрики ячейки учитывает полную настройку рендеринга элементов в ComboBox.
|
ObjectProperty<StringConverter<T>> |
converterProperty()
|
ReadOnlyObjectProperty<TextField> |
editorProperty()
Редактор для ComboBox.
|
ListCell<T> |
getButtonCell()
Получает значение свойства buttonCell.
|
Callback<ListView<T>,ListCell<T>> |
getCellFactory()
Получает значение свойства cellFactory.
|
StringConverter<T> |
getConverter()
Получает значение преобразователя свойства.
|
TextField |
getEditor()
Получает значение редактора свойств.
|
ObservableList<T> |
getItems()
Получает значение элементов свойства.
|
SingleSelectionModel<T> |
getSelectionModel()
Получает значение свойства selectionModel.
|
int |
getVisibleRowCount()
Получает значение свойства visibleRowCount.
|
ObjectProperty<ObservableList<T>> |
itemsProperty()
Список элементов, чтобы показать в пределах раскрывающегося ComboBox.
|
ObjectProperty<SingleSelectionModel<T>> |
selectionModelProperty()
Модель выбора для ComboBox.
|
void |
setButtonCell(ListCell<T> value)
Устанавливает значение свойства buttonCell.
|
void |
setCellFactory(Callback<ListView<T>,ListCell<T>> value)
Устанавливает значение свойства cellFactory.
|
void |
setConverter(StringConverter<T> value)
Устанавливает значение преобразователя свойства.
|
void |
setItems(ObservableList<T> value)
Устанавливает значение элементов свойства.
|
void |
setSelectionModel(SingleSelectionModel<T> value)
Устанавливает значение свойства selectionModel.
|
void |
setVisibleRowCount(int value)
Устанавливает значение свойства visibleRowCount.
|
IntegerProperty |
visibleRowCountProperty()
Максимальное количество строк, чтобы быть видимым в ComboBox, раскрывающемся, когда это показывает.
|
arm, armedProperty, disarm, editableProperty, getOnAction, getOnHidden, getOnHiding, getOnShowing, getOnShown, getPromptText, getValue, hide, isArmed, isEditable, isShowing, onActionProperty, onHiddenProperty, onHidingProperty, onShowingProperty, onShownProperty, promptTextProperty, setEditable, setOnAction, setOnHidden, setOnHiding, setOnShowing, setOnShown, setPromptText, setValue, show, showingProperty, valueProperty
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getHeight, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getPrefHeight, getPrefWidth, getSkin, getTooltip, getUserAgentStylesheet, getWidth, heightProperty, intersects, isResizable, layoutChildren, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, setContextMenu, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setPrefHeight, setPrefSize, setPrefWidth, setSkin, setSkinClassName, setTooltip, setWidth, skinClassNameProperty, skinProperty, tooltipProperty, widthProperty
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, setNeedsLayout
addEventFilter, addEventHandler, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getUserData, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToSceneTransformProperty, lookupAll, managedProperty, mouseTransparentProperty, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, visibleProperty
public ObjectProperty<ObservableList<T>> itemsProperty
getItems()
, setItems(ObservableList)
public ObjectProperty<StringConverter<T>> converterProperty
editable
) к объекту типа T так, что ввод может быть получен через value
свойство.getConverter()
, setConverter(StringConverter)
public ObjectProperty<Callback<ListView<T>,ListCell<T>>> cellFactoryProperty
Cell
javadoc для получения дополнительной информации о фабриках ячейки.getCellFactory()
, setCellFactory(Callback)
public ObjectProperty<ListCell<T>> buttonCellProperty
cell factory
API.getButtonCell()
, setButtonCell(ListCell)
public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty
public final IntegerProperty visibleRowCountProperty
getVisibleRowCount()
, setVisibleRowCount(int)
public final ReadOnlyObjectProperty<TextField> editorProperty
editable
.getEditor()
public ComboBox()
items
список и значение по умолчанию selection model
.public ComboBox(ObservableList<T> items)
selection model
.public final void setItems(ObservableList<T> value)
public final ObservableList<T> getItems()
public ObjectProperty<ObservableList<T>> itemsProperty()
getItems()
, setItems(ObservableList)
public ObjectProperty<StringConverter<T>> converterProperty()
editable
) к объекту типа T так, что ввод может быть получен через value
свойство.getConverter()
, setConverter(StringConverter)
public final void setConverter(StringConverter<T> value)
public final StringConverter<T> getConverter()
public final void setCellFactory(Callback<ListView<T>,ListCell<T>> value)
Cell
javadoc для получения дополнительной информации о фабриках ячейки.public final Callback<ListView<T>,ListCell<T>> getCellFactory()
Cell
javadoc для получения дополнительной информации о фабриках ячейки.public ObjectProperty<Callback<ListView<T>,ListCell<T>>> cellFactoryProperty()
Cell
javadoc для получения дополнительной информации о фабриках ячейки.getCellFactory()
, setCellFactory(Callback)
public ObjectProperty<ListCell<T>> buttonCellProperty()
cell factory
API.getButtonCell()
, setButtonCell(ListCell)
public final void setButtonCell(ListCell<T> value)
cell factory
API.public final ListCell<T> getButtonCell()
cell factory
API.public final void setSelectionModel(SingleSelectionModel<T> value)
public final SingleSelectionModel<T> getSelectionModel()
public final ObjectProperty<SingleSelectionModel<T>> selectionModelProperty()
public final void setVisibleRowCount(int value)
public final int getVisibleRowCount()
public final IntegerProperty visibleRowCountProperty()
getVisibleRowCount()
, setVisibleRowCount(int)
public final TextField getEditor()
editable
.public final ReadOnlyObjectProperty<TextField> editorProperty()
editable
.getEditor()
Copyright (c) 2008, 2012, Oracle и/или его филиалы. Все права защищены. Использование подвергается