Mercurial > hg > xemacs-beta

comparison man/lispref/specifiers.texi @ 2:ac2d302a0011 r19-15b2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r19-15b2
author cvs
date Mon, 13 Aug 2007 08:46:35 +0200
parents 376386a54a3c
children ec9a17fef872
comparison
equal deleted inserted replaced
1:c0c6a60d29db 2:ac2d302a0011
291 All Lisp objects are valid instantiators. Instance objects are the same 291 All Lisp objects are valid instantiators. Instance objects are the same
292 as instantiators so no special instantiation function is needed. 292 as instantiators so no special instantiation function is needed.
293 293
294 @item font 294 @item font
295 The valid instantiators are strings describing fonts or vectors 295 The valid instantiators are strings describing fonts or vectors
296 indicating inheritance from the font of some face. Instance objects 296 indicating inheritance from the font of some face. Instance objects are
297 are font-instance objects, which are specific to a particular device. 297 font-instance objects, which are specific to a particular device. The
298 The instantiation method in this specifier can fail, unlike for 298 instantiation method for font specifiers can fail, unlike for integer,
299 integer, natnum, boolean, and generic specifiers. 299 natnum, boolean, and generic specifiers.
300 300
301 @item color 301 @item color
302 The valid instantiators are strings describing colors or vectors 302 The valid instantiators are strings describing colors or vectors
303 indicating inheritance from the foreground or background of some face. 303 indicating inheritance from the foreground or background of some face.
304 Instance objects are color-instance objects, which are specific to a 304 Instance objects are color-instance objects, which are specific to a
305 particular device. The instantiation method in this specifier can fail, 305 particular device. The instantiation method for color specifiers can fail,
306 as for font specifiers. 306 as for font specifiers.
307 307
308 @item image 308 @item image
309 Images are perhaps the most complicated type of built-in specifier. The 309 Images are perhaps the most complicated type of built-in specifier. The
310 valid instantiators are strings (a filename, inline data for a pixmap, 310 valid instantiators are strings (a filename, inline data for a pixmap,
311 or text to be displayed in a text glyph) or vectors describing inline 311 or text to be displayed in a text glyph) or vectors describing inline
312 data of various sorts or indicating inheritance from the 312 data of various sorts or indicating inheritance from the
313 background-pixmap property of some face. Instance objects are either 313 background-pixmap property of some face. Instance objects are either
314 strings (for text images), image-instance objects (for pixmap images), 314 strings (for text images), image-instance objects (for pixmap images),
315 or subwindow objects (for subwindow images). The instantiation method 315 or subwindow objects (for subwindow images). The instantiation method
316 in this specifier can fail, as for font and color specifiers. 316 for image specifiers can fail, as for font and color specifiers.
317 317
318 @item face-boolean 318 @item face-boolean
319 The valid instantiators are the symbols @code{t} and @code{nil} and 319 The valid instantiators are the symbols @code{t} and @code{nil} and
320 vectors indicating inheritance from a boolean property of some face. 320 vectors indicating inheritance from a boolean property of some face.
321 Specifiers of this sort are used for all of the built-in boolean 321 Specifiers of this sort are used for all of the built-in boolean
325 @item toolbar 325 @item toolbar
326 The valid instantiators are toolbar descriptors, which are lists 326 The valid instantiators are toolbar descriptors, which are lists
327 of toolbar-button descriptors (each of which is a vector of two 327 of toolbar-button descriptors (each of which is a vector of two
328 or four elements). @xref{Toolbar} for more information. 328 or four elements). @xref{Toolbar} for more information.
329 @end table 329 @end table
330
331 Color and font instance objects can also be used in turn as
332 instantiators for a new color or font instance object. Since these
333 instance objects are device-specific, the instantiator can be used
334 directly as the new instance object, but only if they are of the same
335 device. If the devices differ, the base color or font of the
336 instantiating object is effectively used instead as the instantiator.
330 337
331 @xref{Faces and Window-System Objects} for more information on fonts, 338 @xref{Faces and Window-System Objects} for more information on fonts,
332 colors, and face-boolean specifiers. @xref{Glyphs} for more information 339 colors, and face-boolean specifiers. @xref{Glyphs} for more information
333 about image specifiers. @xref{Toolbar} for more information on toolbar 340 about image specifiers. @xref{Toolbar} for more information on toolbar
334 specifiers. 341 specifiers.