Gtk2::UniqueMessageData(3pm) | User Contributed Perl Documentation | 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-2010 by Emmanuel Rodriguez
2017-07-23 | perl v5.26.0 |