Gtk2::UniqueMessageDatUser Contributed Perl DocumentGtk2::UniqueMessageData(3)NAMEGtk2::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
perl v5.14.1 2011-07-20 Gtk2::UniqueMessageData(3)