~ubuntu-branches/ubuntu/lucid/perl-tk/lucid

« back to all changes in this revision

Viewing changes to pod/Wm.pod

  • Committer: Bazaar Package Importer
  • Author(s): Colin Tuckley
  • Date: 2008-02-15 13:56:59 UTC
  • mfrom: (1.1.3 upstream) (4.1.1 hardy)
  • Revision ID: james.westby@ubuntu.com-20080215135659-ru2oqlykuju20fav
Tags: 1:804.028-1
* New Upstream Release (Closes: #463080).
* Update to Debhelper v5.
* Build with XFT=1 (Closes: #411129).

Show diffs side-by-side

added added

removed removed

Lines of Context:
298
298
case the window manager will normally display the window's title,
299
299
as specified with the B<title> method).
300
300
 
 
301
=item I<$toplevel>-E<gt>B<iconphoto>(?-default? I<image1> ?I<image2>
 
302
...?)
 
303
 
 
304
Sets the titlebar icon for  window  based  on  the  named  photo
 
305
images.  If -default is specified, this is applied to all future
 
306
created toplevels as well.  The data in the images is taken as a
 
307
snapshot  at  the  time  of invocation.  If the images are later
 
308
changed, this is not reflected to the titlebar icons.   Multiple
 
309
images  are  accepted to allow different images sizes (eg, 16x16
 
310
and 32x32) to be provided.  The window manager  may  scale  pro-
 
311
vided icons to an appropriate size.
 
312
 
 
313
On Windows, the images are packed into a Windows icon structure.
 
314
This will override an ico specified to wm iconbitmap,  and  vice
 
315
versa. [NOTE: This is not implemented yet!]
 
316
 
 
317
On  X, the images are arranged into the _NET_WM_ICON X property,
 
318
which most modern window managers support.  A wm iconbitmap  may
 
319
exist  simultaneously.  It is recommended to use not more than 2
 
320
icons, placing the larger icon first.
 
321
 
 
322
On Macintosh, this is currently does nothing.
 
323
 
301
324
=item I<$toplevel>-E<gt>B<iconposition>(?I<x y>?)
302
325
 
303
326
If I<x> and I<y> are specified, they are passed to the window