Класс MaskFormatter

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

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

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

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

   MaskFormatter formatter = new MaskFormatter("###-####");
   formatter.setPlaceholderCharacter('_');
   formatter.getDisplayValue(tf, "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.