Gtk2::UniqueMessageData(3)

NAME
Gtk2::UniqueMessageData - Message container for Gtk2::UniqueApp

DESCRIPTION
This class wraps the messages passed to a "Gtk2::UniqueApp". Usually you will never create a message with the Perl API has this is done by the bindings on your behalf. Since messages are only read through the Perl bidings the methods for setting the contents of a message are not accessible.

What's important to understand is that a "Gtk2::MessageData" is a generic container for all message types (text, data, filename and uris). There's no way to query what kind of message a "Gtk2::MessageData" holds. It is the responsability of each application to know it in advance and to call the proper get methods. If you don't call the proper get method you could have a segmentation fault in your application as the C library will try to unmarshall the message with the wrong code.

You can retrieve the data set using "Gkt2::MessageData::get()", "Gkt2::MessageData::get_text()" or "Gkt2::MessageData::get_uris()".

HIERARCHY
  Glib::Boxed
  +----Gtk2::UniqueMessageData

METHODS

  string = $message_data->get_filename
Retrieves the filename.

  scalar = $message_data->get
Retrieves the raw data of the message.

  screen = $message_data->get_screen
Returns a pointer to the screen from where the message came. You can use "Gkt2::Window::set_screen()" to move windows or dialogs to the right screen. This field is always set by the Unique library.

  string = $message_data->get_startup_id
Retrieves the startup notification id set inside message_data. This field is always set by the Unique library.

  string = $message_data->get_text
Retrieves the text.

  $message_data->get_uris
Retrieves the URIs as an array.

  integer = $message_data->get_workspace
Retrieves the workspace number from where the message came. This field is always set by the Unique library.

SEE ALSO
Gtk2::Unique, Glib::Boxed

COPYRIGHT
Copyright (C) 2009-2010 by Emmanuel Rodriguez