Простые типы

В этом разделе описаны все простые типы настройки. Для нескольких из этих типов настройки виджет настройки поддерживает автодополнение непосредственно в строке с помощью C-M-i или M-TAB.

sexp

Значением может быть любой объект Lisp, который можно вывести и прочитать обратно. Для любого параметра в качестве запасного варианта можно использовать sexp, если вы не хотите тратить время на подбор более подходящего типа.

integer

Значением должно быть целое число.

natnum

Значением должно быть неотрицательное целое число.

number

Значением должно быть число (с плавающей точкой или целое).

float

Значением должно быть число с плавающей точкой.

string

Значением должна быть строка. В буфере настройки строка отображается без ограничивающих символов ‘"’ и экранирующих символов ‘\’.

regexp

Аналогично string, но строка должна быть допустимым регулярным выражением.

character

Значением должен быть код символа. Код символа фактически является целым числом, однако этот тип отображает значение, вставляя символ в буфер, а не показывая число.

file

Значением должно быть имя файла. Виджет поддерживает автодополнение.

(file :must-match t)

Значением должно быть имя существующего файла. Виджет поддерживает автодополнение.

directory

Значением должен быть каталог. Виджет поддерживает автодополнение.

hook

Значением должен быть список функций. Этот тип настройки используется для переменных-хуков. В defcustom переменной-хука можно использовать ключевое слово :options, чтобы указать список функций, рекомендуемых для использования в хуке; см. раздел Определение переменных настройки.

symbol

Значением должен быть символ. В буфере настройки он отображается как имя символа. Виджет поддерживает автодополнение.

function

Значением должно быть либо лямбда-выражение, либо имя функции. Для имен функций виджет поддерживает автодополнение.

buffer-predicate

Значением должна быть форма, подходящая для аргумента condition функции buffer-match-p (см. раздел Список буферов). Это удобно для параметров, значение которых передаётся в buffer-match-p для выбора подходящих буферов.

variable

Значением должно быть имя переменной. Виджет поддерживает автодополнение.

face

Значением должен быть символ, являющийся именем грани. Виджет поддерживает автодополнение.

boolean

Значение является логическим: либо nil, либо t. Обратите внимание: используя вместе choice и const (см. следующий раздел), можно указать, что значение должно быть nil или t, а также задать текст для описания каждого значения с учётом конкретного смысла соответствующего варианта.

key

Значение является допустимой клавишей согласно key-valid-p и подходит для использования, например, с keymap-set.

key-sequence

Значением должна быть последовательность клавиш. В буфере настройки последовательность клавиш отображается в том же синтаксисе, что и в функции kbd. См. раздел Последовательности клавиш. Это устаревший тип; вместо него используйте key.

coding-system

Значением должно быть имя системы кодирования; для автодополнения можно использовать M-TAB.

color

Значением должно быть допустимое имя цвета. Виджет поддерживает автодополнение имен цветов, а также показывает образец цвета и кнопку для выбора имени цвета из списка в буфере *Colors*.

fringe-bitmap

Значением должно быть допустимое имя растрового изображения полей. Виджет поддерживает автодополнение.