Класс MaskFormatter

Обычно символы соответствуют одному символу, но в некоторых языках это не так. Маска основана на каждом символе и, таким образом, будет подстраиваться под количество необходимых символов.

Вы можете дополнительно ограничить символы, которые могут быть введены методами setInvalidCharacters и setValidCharacters. setInvalidCharacters позволяет указать, какие символы недопустимы. setValidCharacters позволяет указать, какие символы допустимы. Например, следующий фрагмент кода эквивалентен маске '0xHHH' без недопустимых/допустимых символов:

 MaskFormatter formatter = new MaskFormatter("0x***");
 formatter.setValidCharacters("0123456789abcdefABCDEF");
 

При форматировании значения, если длина строки меньше длины маски, могут произойти две вещи. Либо будет использоваться строка-заполнитель, либо символ-заполнитель. Преимущество отдаётся строке-заполнителю. Например:

   MaskFormatter formatter = new MaskFormatter("###-####");
   formatter.setPlaceholderCharacter('_');
   System.out.println(formatter.valueToString("123"));
 

Результатом будет строка '123-____'. Если setPlaceholder("555-1212") был вызван, результатом будет '123-1212'. Строка-заполнитель используется только при первоначальном форматировании, при последующих форматированиях используется только символ-заполнитель.

Если MaskFormatter настроен на разрешение только допустимых символов (setAllowsInvalid(false)), буквенные символы будут пропущены по мере необходимости при редактировании. Рассмотрим MaskFormatter с маской "###-####" и текущим значением "555-1212". Использование правой стрелки для навигации по полю приведет к (| указывает положение курсора):

   |555-1212
   5|55-1212
   55|5-1212
   555-|1212
   555-1|212
 

Аналогичное поведение будет при редактировании. Рассмотрим вставку строк '123-45' и '12345' в MaskFormatter в предыдущем примере. Обе вставки приведут к той же строке '123-45__'. Когда MaskFormatter обрабатывает вставку в позиции символа 3 (символ '-'), могут произойти следующие события:

1. Если вставленный символ — '-', он принимается.
2. Если вставленный символ соответствует маске для следующего небуквенного символа, он принимается в новом месте.
3. В противном случае редактирование считается недопустимым.

По умолчанию MaskFormatter не будет допускать недопустимых правок, вы можете изменить это с помощью метода setAllowsInvalid, и будет подтверждать корректные правки (используйте setCommitsOnValidEdit для изменения этого).

По умолчанию MaskFormatter находится в режиме перезаписи. То есть, когда набираются символы, новый символ не вставляется, а символ в текущем месте заменяется на набранный символ. Вы можете изменить это поведение с помощью метода setOverwriteMode.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans. Пожалуйста, обратитесь к XMLEncoder.