Next: , Previous: , Up: Specifiers   [Contents][Index]


48.11 Creating New Specifier Objects

Function: make-specifier type

This function creates a new specifier.

A specifier is an object that can be used to keep track of a property whose value can be per-buffer, per-window, per-frame, or per-device, and can further be restricted to a particular device-type or device-class. Specifiers are used, for example, for the various built-in properties of a face; this allows a face to have different values in different frames, buffers, etc. For more information, see specifier-instance, specifier-specs, and add-spec-to-specifier; or, for a detailed description of specifiers, including how they are instantiated over a particular domain (i.e. how their value in that domain is determined), see the chapter on specifiers in the SXEmacs Lisp Reference Manual.

type specifies the particular type of specifier, and should be one of the symbols generic, integer, natnum, boolean, color, font, image, face-boolean, or toolbar.

For more information on particular types of specifiers, see the functions make-generic-specifier, make-integer-specifier, make-natnum-specifier, make-boolean-specifier, make-color-specifier, make-font-specifier, make-image-specifier, make-face-boolean-specifier, and make-toolbar-specifier.

Function: make-specifier-and-init type spec-list &optional dont-canonicalize

This function creates and initializes a new specifier.

This is a convenience API combining make-specifier and set-specifier that allows you to create a specifier and add specs to it at the same time. type specifies the specifier type. Allowed types are as for make-specifier.

spec-list supplies the specification(s) to be added to the specifier. Any abbreviation of the full spec-list form accepted by canonicalize-spec-list may be used. However, if the optional argument dont-canonicalize is non-nil, canonicalization is not performed, and the spec-list must already be in full form.

Function: make-integer-specifier spec-list

Return a new integer specifier object with the given specification list. spec-list can be a list of specifications (each of which is a cons of a locale and a list of instantiators), a single instantiator, or a list of instantiators.

Valid instantiators for integer specifiers are integers.

Function: make-boolean-specifier spec-list

Return a new boolean specifier object with the given specification list. spec-list can be a list of specifications (each of which is a cons of a locale and a list of instantiators), a single instantiator, or a list of instantiators.

Valid instantiators for boolean specifiers are t and nil.

Function: make-natnum-specifier spec-list

Return a new natnum specifier object with the given specification list. spec-list can be a list of specifications (each of which is a cons of a locale and a list of instantiators), a single instantiator, or a list of instantiators.

Valid instantiators for natnum specifiers are non-negative integers.

Function: make-generic-specifier spec-list

Return a new generic specifier object with the given specification list. spec-list can be a list of specifications (each of which is a cons of a locale and a list of instantiators), a single instantiator, or a list of instantiators.

Valid instantiators for generic specifiers are all Lisp values. They are returned back unchanged when a specifier is instantiated.

Function: make-display-table-specifier spec-list

Return a new display-table specifier object with the given spec list. spec-list can be a list of specifications (each of which is a cons of a locale and a list of instantiators), a single instantiator, or a list of instantiators.

Valid instantiators for display-table specifiers are described in detail in the doc string for current-display-table (see Active Display Table).


Next: , Previous: , Up: Specifiers   [Contents][Index]