Класс ProgressBarTreeTableCell<S>

public ProgressBarTreeTableCell()

Создаёт экземпляр ProgressBarTreeTableCell по умолчанию

public static <S> Callback<TreeTableColumn<S,Double>,TreeTableCell<S,Double>> forTreeTableColumn()

Обеспечивает ProgressBar, который позволяет легко визуализировать числовое значение, когда оно увеличивается от 0,0 до 1,0. Если значение равно -1, полоса прогресса будет отображаться неопределённо.

public void updateItem(Double item, boolean empty)

Метод updateItem не должен вызываться разработчиками, но это лучший метод для переопределения разработчиками, чтобы позволить им настроить визуальное представление ячейки. Для ясности, разработчики никогда не должны вызывать этот метод в своём коде (они должны предоставить контролю пользовательского интерфейса, например, контролю ListView, вызвать этот метод). Однако назначение метода updateItem заключается в том, чтобы разработчики, при указании пользовательских фабрик ячеек (опять же, как ListView cell factory), могли переопределить метод updateItem, чтобы разрешить полную настройку ячейки.

Очень важно, чтобы подклассы Cell надлежащим образом переопределяли метод updateItem, поскольку при его неправильном выполнении могут возникнуть проблемы, такие как пустые ячейки или ячейки с неожиданным содержимым, отображающимся внутри них. Вот пример правильного переопределения метода updateItem:

 protected void updateItem(T item, boolean empty) {
     super.updateItem(item, empty);

     if (empty || item == null) {
         setText(null);
         setGraphic(null);
     } else {
         setText(item.toString());
     }
 }
 

Обратите внимание на два важных момента в этом примере кода:

1. Мы вызываем метод super.updateItem(T, boolean). Если этого не сделать, свойства item и empty не будут правильно установлены, и у вас, вероятно, возникнут графические проблемы.
2. Мы проверяем условие empty, и если оно истинно, устанавливаем свойства text и graphic в null. Если мы этого не сделаем, почти гарантировано, что конечные пользователи увидят графические артефакты в ячейках неожиданным образом.