man Gtk2::UniqueMessageData (3): 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.