Gtk2::UniqueMessageData(3pm)
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 by Emmanuel Rodriguez