NAME

X11::Tops

SYNOPSIS

  use X11::Tops;
  $xtops = X11::Tops->new;

  use X11::Tops;
  $X = X11::Protocol->new;
  $xtops = X11::Tops->new($X);
  @xtops = X11::Tops->new($X)->sort;

  print $xtops->[0]->class, "\n";
  print $xtops->[0]->instance, "\n";
  print $xtops->[0]->icon, "\n";
  print $xtops->[0]->title, "\n";

  for my $xtop (@$xtops) { print $xtop->instance, "\n" }

  $xtop = $xtops->match('instance', qr/gecko/i);
  $xtop = $xtops->instance(qr/gecko/i);
  $xtop = $xtops->icon(qr/gecko/i);

  $xtop->char('q');
  $xtop->char;

  ($xtops, @deleted) = $xtops->update;

  $xtop->monitor_property_change
  X11::Top::monitor_property_change($X->root);

DESCRIPTION

An X11::Tops object is an array of X11::Top objects.

Both classes have class, instance, title & icon methods. For X11::Tops there is a regex argument & the method returns an X11::Top object whose corresponding property matches the regex. For X11::Top there is no argument (other than the object) & the corresponding property is returned. Class & instance are handled separately even though they come from the same property (WM_CLASS). Values of class & instance are assumed not to change (so are cached).

The X11::Top method char gets or sets a (non-standard) property _XCHAR_CHAR. Normally the character name of a toplevel is derived from the instance name.

RCS

 $Source: /home/keck/lib/perl/X11/RCS/Tops.pm,v $
 $Revision: 3.19 $
 $Date: 2007/07/01 14:48:29 $