summaryrefslogtreecommitdiff
path: root/doc/python/openbox.txt
diff options
context:
space:
mode:
authorDana Jansens <danakj@orodu.net>2003-03-21 18:41:36 +0000
committerDana Jansens <danakj@orodu.net>2003-03-21 18:41:36 +0000
commita36c7543d4eedaa9e10bfd9f4d9b81279b1bb7e6 (patch)
tree85483cecb92e82fa6c2e2c2b175d6bc6d0a6b28d /doc/python/openbox.txt
parent327a0b3de75187a23bb01ce5e8e6992fd1106a81 (diff)
rm the python api docs
Diffstat (limited to 'doc/python/openbox.txt')
-rw-r--r--doc/python/openbox.txt208
1 files changed, 0 insertions, 208 deletions
diff --git a/doc/python/openbox.txt b/doc/python/openbox.txt
deleted file mode 100644
index b18c8d3f..00000000
--- a/doc/python/openbox.txt
+++ /dev/null
@@ -1,208 +0,0 @@
-ob.Openbox
-
-----
-
-This document describes the 'Openbox' class, exposed by Openbox's 'ob' module
-to its python scripts.
-
-----
-
-Methods
-
-----
-
-shutdown()
-
-Causes Openbox to shutdown and exit.
-
-
-----
-
-restart([path])
-
-Causes Openbox to shutdown and restart. If path is specified, Openbox will
-shutdown and attempt to run the specified executable instead of restarting
-itself. If that fails, however, it will restart itself.
-
- path: Optional path to replacement executable.
-
-----
-
-state()
-
-Returns Openbox's current state, this will be one of the State constants.
-
- Returns: One of the State values representing the internal state
- of Openbox.
-
-----
-
-desktop()
-
-Returns the number of the currently visible desktop. This will be in the range
-of [0, numDesktops()).
-
- Returns: The currently visible desktop.
-
-----
-
-setDesktop(desktop)
-
-Sets the specified desktop as the visible desktop.
-
- desktop: The desktop to make visible. Must be in the range of
- [0, numDesktops()) or a ValueError exception will be raised.
-
-----
-
-setNextDesktop([wrap])
-
-Sets the visible desktop to the next desktop, optionally wrapping around when
-reaching the last.
-
- wrap: An optional argument which, when True will cause the function to
- wrap to the first desktop when going past the last. If it is not
- specified, it defaults to true.
-
-----
-
-setPreviousDesktop([wrap])
-
-Sets the visible desktop to the previous desktop, optionally wrapping around
-when reaching the first.
-
- wrap: An optional argument which, when True will cause the function to
- wrap to the last desktop when going past the first. If it is not
- specified, it defaults to true.
-
-----
-
-numDesktops()
-
-Returns the number of desktops available.
-
- Returns: The number of available desktops.
-
-----
-
-setNumDesktops(num)
-
-Sets the number of desktops available.
-
- num: The new number of available desktops. This must be greater than 0.
-
-----
-
-desktopNames()
-
-Returns a tuple of names, containing a name for each desktop. The tuple may
-have a length greater than numDesktops() if more names have been specified.
-
- Returns: A tuple of names.
-
-----
-
-setDesktopNames(names)
-
-Sets the names for the desktops.
-
- names: An iterable list of names to apply to the desktops. Can contain
- more or less names than numDesktops(). If it contains fewer
- names, then Openbox will give the remaining desktops a
- placeholder name.
-
-----
-
-showingDesktop()
-
-Returns True or False, depicting if Openbox is in 'showing the desktop' mode.
-In 'showing the desktop' mode, all normal clients are hidden and the desktop
-is given focus if possible.
-
- Returns: True or False describing if Openbox is in 'showing the
- desktop' mode.
-
-----
-
-setShowingDesktop(show)
-
-Enters or leaves 'showing the desktop' mode. See showingDesktop() for a
-description of this mode.
-
- show: True or False to enter or leave 'showing the desktop' mode
- respectively.
-
-----
-
-screenArea(desktop)
-
-Returns the on-screen available area. This is the area not reserved by
-applications' struts. Windows should be placed within this area, not within
-the physicalSize().
-
- desktop: The desktop for which to get the available area. 0xffffffff to
- get the combined area for all desktops (combined
- subtractively).
-
- Returns: A tuple of form (x, y, width, height) containing the
- dimensions of the available on-screen area for the desktop.
-
-
-----
-
-screenStrut(desktop)
-
-Returns the combined strut which has been reserved by all applications on the
-desktops.
-
- desktop: The desktop for which to get the strut. 0xffffffff to get the
- combined strut for all desktops (combined additively).
-
- Returns: A tuple of form (left, top, right, bottom) containing the
- size of the reserved strut space for the desktop.
-
-----
-
-physicalSize()
-
-Returns the physical size of the display device (in pixels).
-
- Returns: A tuple of the form (width, height) containing the size of
- the display device's area.
-
-----
-
-screenNumber()
-
-Returns the number of the screen on which Openbox is running.
-
- Returns: An integer specifying the screen on which this instance of
- Openbox is running.
-
-----
-
-rootWindow()
-
-Return the window id of the root window.
-
- Returns: An integer containing the window id of the root window.
-
-----
-
-clientList()
-
-Returns a all clients currently being managed by Openbox. This list is updated
-as clients are managed and closed/destroyed/released.
-
- Returns: A list of Clients containing all the clients managed by
- Openbox.
-
-----
-
-ob.State
-
-State.Starting: Openbox is starting up and has not yet reached its
- main event loop.
-State.Running: Openbox is running normally.
-State.Exiting: Openbox has left its main event loop and is shutting
- down.