FBB::Xpointer(3bobcat)

Sets the X-pointer
(libbobcat-dev_4.08.03-x.tar.gz)

2005-2018

NAME

FBB::Xpointer - Sets the location of the X-windows pointer

SYNOPSIS

#include <bobcat/xpointer>

Linking option: -lbobcat -lX11

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 Exception exception if the display cannot be opened. With multiple Xpointer objects, the connection to the display is opened only once.
This constructor throws an Exception exception if it could not connect to the Display.

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.

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

BUGS

Note that -lX11 must be specified as well.

DISTRIBUTION FILES

bobcat_4.08.03-x.dsc: detached signature;
bobcat_4.08.03-x.tar.gz: source archive;
bobcat_4.08.03-x_i386.changes: change log;
libbobcat1_4.08.03-x_*.deb: debian package holding the libraries;
libbobcat1-dev_4.08.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).

AUTHOR

Frank B. Brokken (f.b.brokken@rug.nl).