libbobcat1-dev_2.02.03-x.tar.gz Sets the X-pointer
2005-2009
NAME
FBB::Xpointer - Sets the location of the X-windows pointer
SYNOPSIS
#include <bobcat/xpointer>
Linking option: -lX11 -lbobcat
DESCRIPTION
This class allows programs running within the X-graphical environment to
set and retrieve the X-windows pointer location.
NAMESPACE
FBB
All constructors, members, operators and manipulators, mentioned in this
man-page, are defined in the namespace FBB.
INHERITS FROM
-
CONSTRUCTORS
Xpointer():
The default constructor. Connects to the Display. throws an Errno
exception if the display cannot be opened. With multiple Xpointer objects,
the connection to the display is opened only once.
The proper completion of this constructor should be checked by calling
the Xpointer::verify() member (see below).
The copy constructor is available.
MEMBER FUNCTIONS
bool get(int *x, int *y) const:
Returns in its arguments the currnet pointer coordinates relative to
the root-window. On success true is returned; false is returned if the
pointer could not be moved.
bool set(int x, int y) const:
Sets the pointer to a location whose pixel coordinates are given with
respect to the root-window. A negative x-coordinate is measured from the
right screen-margin of the root window (going left), a negative y-coordinate
is measured from the bottom screen-margin of the root window (going up). On
success true is returned; false is returned if the pointer could not
be moved.
void verify() const:
This operator throws an Errno exception if the Xpointer
constructor could not connect to the Display. It should be called before using
any other Xpointer member (not required after using the copy constructor).
EXAMPLE
#include <iostream>
#include <string>
#include <bobcat/xpointer>
using namespace FBB;
int main()
try
{
Xpointer xpointer;
xpointer.verify();
if (!xpointer.set(100, 200))
throw string("Set pointer failed");
int x;
int y;
if (!xpointer.get(&x, &y))
throw string("Get pointer failed");
cout << "Pointer now at " << x << ", " << y << endl;
return 0;
}
catch (string msg)
{
cout << msg << endl;
return 1;
}
FILES
bobcat/xpointer - defines the class interface
SEE ALSO
bobcat(7)
BUGS
Note that -lX11 must be specified before -lbobcat.
DISTRIBUTION FILES
bobcat_2.02.03-x.dsc: detached signature;
bobcat_2.02.03-x.tar.gz: source archive;
bobcat_2.02.03-x_i386.changes: change log;
libbobcat1_2.02.03-x_*.deb: debian package holding the
libraries;
libbobcat1-dev_2.02.03-x_*.deb: debian package holding the
libraries, headers and manual pages;
http://sourceforge.net/projects/bobcat: public archive location;
BOBCAT
Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.
COPYRIGHT
This is free software, distributed under the terms of the
GNU General Public License (GPL).