Handling Mouse Input

SDL_MouseButtonEvent Structure

What is the SDL_MouseButtonEvent structure used for?

Abstract art representing computer programming

The SDL_MouseButtonEvent structure in SDL is used to handle mouse button events. These events occur when the user presses or releases a mouse button.

The structure provides detailed information about the event, such as which button was pressed, the position of the cursor, and the click state.

Structure Definition

Here is the definition of the SDL_MouseButtonEvent structure:

typedef struct SDL_MouseButtonEvent {
  Uint32 type;      // Event type, SDL_MOUSEBUTTONDOWN or SDL_MOUSEBUTTONUP
  Uint32 timestamp; // Timestamp of the event
  Uint32 windowID;  // The window with mouse focus
  Uint32 which;     // The mouse instance ID
  Uint8 button;     // The mouse button index
  Uint8 state;      // SDL_PRESSED or SDL_RELEASED
  Uint8 clicks;     // 1 for single-click, 2 for double-click
  Sint32 x;         // X coordinate of the mouse
  Sint32 y;         // Y coordinate of the mouse
} SDL_MouseButtonEvent;

Key Members

  • type: The type of event, either SDL_MOUSEBUTTONDOWN (button pressed) or SDL_MOUSEBUTTONUP (button released).
  • button: The mouse button that was pressed or released. Common values include SDL_BUTTON_LEFT, SDL_BUTTON_RIGHT, and SDL_BUTTON_MIDDLE.
  • state: Indicates whether the button is pressed (SDL_PRESSED) or released (SDL_RELEASED).
  • clicks: Number of clicks, useful for detecting single or double clicks.
  • x, y: The coordinates of the mouse cursor when the event occurred.

Usage Example

Here’s an example of handling mouse button events using the SDL_MouseButtonEvent structure:

#include <SDL.h>
#include <iostream>

void HandleMouseButtonEvent(
  const SDL_MouseButtonEvent& buttonEvent) {
  if (buttonEvent.state == SDL_PRESSED) {
    std::cout << "Mouse button pressed at ("
      << buttonEvent.x << ", "
      << buttonEvent.y << ")\n";
  } else if (buttonEvent.state == SDL_RELEASED) {
    std::cout << "Mouse button released at ("
      << buttonEvent.x << ", "
      << buttonEvent.y << ")\n";

int main(int argc, char* argv[]) {
  if (SDL_Init(SDL_INIT_VIDEO) != 0) {
    std::cerr << "SDL_Init Error: "
      << SDL_GetError() << '\n';
    return 1;

  SDL_Window* window = SDL_CreateWindow(
    "Mouse Button Event",
    100, 100, 640, 480,

  if (window == nullptr) {
    std::cerr << "SDL_CreateWindow Error: "
      << SDL_GetError() << '\n';
    return 1;

  SDL_Event event;
  bool running = true;
  while (running) {
    while (SDL_PollEvent(&event)) {
      if (event.type == SDL_QUIT) {
        running = false;
      } else if (event.type == SDL_MOUSEBUTTONDOWN ||
                 event.type == SDL_MOUSEBUTTONUP) {

  return 0;
Mouse button pressed at (200, 150)
Mouse button released at (200, 150)


The SDL_MouseButtonEvent structure is essential for handling mouse button events in SDL. It provides detailed information, including the type of button event, the button involved, the state (pressed or released), the number of clicks, and the cursor's position.

By understanding and utilizing this structure, you can effectively manage mouse interactions in your SDL applications.

This Question is from the Lesson:

Handling Mouse Input

Learn how to detect and handle mouse input events in SDL, including mouse motion, button clicks, and window entry/exit.

Answers to questions are automatically generated and may not have been reviewed.

This Question is from the Lesson:

Handling Mouse Input

Learn how to detect and handle mouse input events in SDL, including mouse motion, button clicks, and window entry/exit.

Part of the course:

Game Dev with SDL2

Learn C++ and SDL development by creating hands on, practical projects inspired by classic retro games

Free, unlimited access

This course includes:

  • 36 Lessons
  • 100+ Code Samples
  • 91% Positive Reviews
  • Regularly Updated
  • Help and FAQ
Free, Unlimited Access

Professional C++

Comprehensive course covering advanced concepts, and how to use them on large-scale projects.

Screenshot from Warhammer: Total War
Screenshot from Tomb Raider
Screenshot from Jedi: Fallen Order
Contact|Privacy Policy|Terms of Use
Copyright © 2024 - All Rights Reserved