Gtk2::UniqueMessageData (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/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 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