---
name: "CL_Event_ButtonRelease"
section: "3"
platform: "linux"
package: "clanlib0-common-dev"
version: "0.4.4-8"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/CL_Event_ButtonRelease"
---

# CL\_Event\_ButtonRelease(3)

Event callback interface for button releases.

## NAME

CL\_Event\_ButtonRelease - Event callback interface for button releases.

## DESCRIPTION

This interface is used to intercept button releases from the keyboard, mouse and joystick. To use this interface, inherit it and implement on\_button\_release(). Then add it to a CL\_EventChain\_ButtonRelease chain. The topmost chain is located in CL\_Input. ClanLib has some common case inheritance of most of our events, and you may want to have a look at them before using this interface. One example is the CL\_InputBuffer class, which converts button events into a poll queue.

Inherited from public virtual CL\_Event

## CLASS MEMBERS

- virtual **~CL\_Event\_ButtonRelease**()

  - virtual bool **on\_button\_release**(

  ```
   CL_InputDevice *device,
  const CL_Key &key)
  ```

## MEMBERS WITH DESCRIPTIONS

- virtual **~CL\_Event\_ButtonRelease**()

  ```
  Description:
  ```

- virtual bool **on\_button\_release**(

  ```
   CL_InputDevice *device,
  const CL_Key &key)
  ```

  ```
  Parameters:
  device - Input device where the event originates from.
  key - The key/button that triggered the event.
  ```

  ```
  Description:
  ```

  Called when a button release event occours.

  ```
  Return value:
  ```

  If true is returned, the event chain that called this function will break the chain (stop sending it the remaining listeners on the chain.

## SEE ALSO

All ClanLib API classes can be found in **clanlib (3)**.

## AUTHORS

Originally written by Magnus Norddahl \<*mbn@dark.x.dtu.dk*\> and Martin Starch \<*starch@dark.x.dtu.dk*\>. ClanLib is now developed by the ClanLib Development team as an Open Source project.

The ClanLib man pages was created using the Perceps documentation system (another excellent piece of Open Source software, available at **http://somewhere.in.the.world.org**).

See **clanlib (3)** to find out how to get a full list of contributors and details on how to submit bug reports, comments etc.