Spec-Zone .ru
спецификации, руководства, описания, API
|
|
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<Node> |
заполнитель
Этот Узел показывают пользователю, когда у ComboBox нет никакого контента, чтобы показать.
|
ObjectProperty<SingleSelectionModel<T>> |
selectionModel
Модель выбора для ComboBox.
|
IntegerProperty |
visibleRowCount
Максимальное количество строк, чтобы быть видимым в ComboBox, раскрывающемся, когда это показывает.
|
armed, editable, onAction, onHidden, onHiding, onShowing, onShown, promptText, showing, valuecontextMenu, skin, tooltipbackground, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, widthneedsLayoutblendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, 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, visibleON_HIDDEN, ON_HIDING, ON_SHOWING, ON_SHOWNUSE_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()
|
protected Skin<?> |
createDefaultSkin()
Создайте новый экземпляр кожи значения по умолчанию для этого управления.
|
ReadOnlyObjectProperty<TextField> |
editorProperty()
Редактор для ComboBox.
|
ListCell<T> |
getButtonCell()
Получает значение свойства buttonCell.
|
Callback<ListView<T>,ListCell<T>> |
getCellFactory()
Получает значение свойства cellFactory.
|
StringConverter<T> |
getConverter()
Получает значение преобразователя свойства.
|
TextField |
getEditor()
Получает значение редактора свойств.
|
ObservableList<T> |
getItems()
Получает значение элементов свойства.
|
Узел |
getPlaceholder()
Получает значение заполнителя свойства.
|
SingleSelectionModel<T> |
getSelectionModel()
Получает значение свойства selectionModel.
|
int |
getVisibleRowCount()
Получает значение свойства visibleRowCount.
|
ObjectProperty<ObservableList<T>> |
itemsProperty()
Список элементов, чтобы показать в пределах раскрывающегося ComboBox.
|
ObjectProperty<Node> |
placeholderProperty()
Этот Узел показывают пользователю, когда у 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 |
setPlaceholder(Node 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, valuePropertycomputeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getClassCssMetaData, getContextMenu, getControlCssMetaData, getCssMetaData, getSkin, getTooltip, getUserAgentStylesheet, isResizable, layoutChildren, setContextMenu, setSkin, setTooltip, skinProperty, tooltipPropertybackgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapSize, snapSpace, snapToPixelProperty, widthPropertygetChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, setNeedsLayoutaddEventFilter, addEventHandler, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, 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, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, 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, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, 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, usesMirroring, visiblePropertypublic 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 final ObjectProperty<Узел> placeholderProperty
emptyText свойство, которое показывают в Кнопке ComboBox / область TextField, когда нет никакого значения ввода данных пользователем.getPlaceholder(), setPlaceholder(Node)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()public final ObjectProperty<Узел> placeholderProperty()
emptyText свойство, которое показывают в Кнопке ComboBox / область TextField, когда нет никакого значения ввода данных пользователем.getPlaceholder(), setPlaceholder(Node)public final void setPlaceholder(Node value)
emptyText свойство, которое показывают в Кнопке ComboBox / область TextField, когда нет никакого значения ввода данных пользователем.public final Узел getPlaceholder()
emptyText свойство, которое показывают в Кнопке ComboBox / область TextField, когда нет никакого значения ввода данных пользователем.protected Skin<?> createDefaultSkin()
-fx-skin или набор явно в sub-class с setSkin(...).createDefaultSkin в class ControlCopyright (c) 2008, 2013, Oracle и/или его филиалы. Все права защищены. Использование подвергается .