.TH "KXMessages" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdecore Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KXMessages \- Sending string messages to other applications using the X Client Messages.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kxmessages.h>\fP
.PP
Inherits \fBQWidget\fP.
.PP
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBgotMessage\fP (const \fBQString\fP &message)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKXMessages\fP (const char *accept_broadcast, \fBQWidget\fP *parent, bool obsolete)"
.br
.ti -1c
.RI "\fBKXMessages\fP (const char *accept_broadcast=NULL, \fBQWidget\fP *parent=NULL)"
.br
.ti -1c
.RI "void \fBsendMessage\fP (WId w, const char *msg_type, const \fBQString\fP &message, bool obsolete)"
.br
.ti -1c
.RI "void \fBsendMessage\fP (WId w, const char *msg_type, const \fBQString\fP &message)"
.br
.ti -1c
.RI "void \fBbroadcastMessage\fP (const char *msg_type, const \fBQString\fP &message, int screen, bool obsolete)"
.br
.ti -1c
.RI "void \fBbroadcastMessage\fP (const char *msg_type, const \fBQString\fP &message)"
.br
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "static bool \fBsendMessageX\fP (Display *disp, WId w, const char *msg_type, const \fBQString\fP &message, bool obsolete)"
.br
.ti -1c
.RI "static bool \fBsendMessageX\fP (Display *disp, WId w, const char *msg_type, const \fBQString\fP &message)"
.br
.ti -1c
.RI "static bool \fBbroadcastMessageX\fP (Display *disp, const char *msg_type, const \fBQString\fP &message, int screen, bool obsolete)"
.br
.ti -1c
.RI "static bool \fBbroadcastMessageX\fP (Display *disp, const char *msg_type, const \fBQString\fP &message)"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual bool \fBx11Event\fP (XEvent *ev)"
.br
.in -1c
.SH "Detailed Description"
.PP 
Sending string messages to other applications using the X Client Messages. 

Used internally by \fBKStartupInfo\fP. You usually don't want to use this, use DCOP instead.
.PP
\fBAuthor:\fP
.RS 4
Lubos Lunak <l.lunak@kde.org> 
.RE
.PP

.PP
Definition at line 47 of file kxmessages.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KXMessages::KXMessages (const char * accept_broadcast, \fBQWidget\fP * parent, bool obsolete)"
.PP
Creates an instance which will receive X messages. 
.PP
\fBParameters:\fP
.RS 4
\fIaccept_broadcast\fP if non-NULL, all broadcast messages with this message type will be received. 
.br
\fIparent\fP the parent of this widget 
.br
\fIobsolete\fP always set to false (needed for backwards compatibility with KDE3.1 and older)
.RE
.PP

.PP
Definition at line 57 of file kxmessages.cpp.
.PP
References QWidget::QWidget().
.SS "KXMessages::KXMessages (const char * accept_broadcast = \fCNULL\fP, \fBQWidget\fP * parent = \fCNULL\fP)"
.PP
\fBDeprecated\fP
.RS 4
This method is equivalent to the other constructor with obsolete = true. 
.RE
.PP

.PP
Definition at line 40 of file kxmessages.cpp.
.PP
References QWidget::QWidget().
.SH "Member Function Documentation"
.PP 
.SS "void KXMessages::sendMessage (WId w, const char * msg_type, const \fBQString\fP & message, bool obsolete)"
.PP
Sends the given message with the given message type only to given window. 
.PP
\fBParameters:\fP
.RS 4
\fIw\fP X11 handle for the destination window 
.br
\fImsg_type\fP the type of the message 
.br
\fImessage\fP the message itself 
.br
\fIobsolete\fP always set to false (needed for backwards compatibility with KDE3.1 and older)
.RE
.PP

.PP
Definition at line 101 of file kxmessages.cpp.
.PP
References QWidget::winId().
.PP
Referenced by sendMessage().
.SS "void KXMessages::sendMessage (WId w, const char * msg_type, const \fBQString\fP & message)"
.PP
\fBDeprecated\fP
.RS 4
This method is equivalent to \fBsendMessage()\fP with obsolete = true. 
.RE
.PP

.PP
Definition at line 96 of file kxmessages.cpp.
.PP
References sendMessage().
.SS "void KXMessages::broadcastMessage (const char * msg_type, const \fBQString\fP & message, int screen, bool obsolete)"
.PP
Broadcasts the given message with the given message type. 
.PP
\fBParameters:\fP
.RS 4
\fImsg_type\fP the type of the message 
.br
\fImessage\fP the message itself 
.br
\fIscreen\fP X11 screen to use, -1 for the default 
.br
\fIobsolete\fP always set to false (needed for backwards compatibility with KDE3.1 and older)
.RE
.PP

.PP
Definition at line 86 of file kxmessages.cpp.
.PP
References QWidget::winId().
.PP
Referenced by broadcastMessage(), KStartupInfo::sendChange(), KStartupInfo::sendFinish(), and KStartupInfo::sendStartup().
.SS "void KXMessages::broadcastMessage (const char * msg_type, const \fBQString\fP & message)"
.PP
\fBDeprecated\fP
.RS 4
This method is equivalent to \fBbroadcastMessage()\fP with obsolete = true. 
.RE
.PP

.PP
Definition at line 81 of file kxmessages.cpp.
.PP
References broadcastMessage().
.SS "bool KXMessages::sendMessageX (Display * disp, WId w, const char * msg_type, const \fBQString\fP & message, bool obsolete)\fC [static]\fP"
.PP
Sends the given message with the given message type only to given window. 
.PP
\fBParameters:\fP
.RS 4
\fIdisp\fP X11 connection which will be used instead of qt_x11display() 
.br
\fIw\fP X11 handle for the destination window 
.br
\fImsg_type\fP the type of the message 
.br
\fImessage\fP the message itself 
.br
\fIobsolete\fP always set to false (needed for backwards compatibility with KDE3.1 and older) 
.RE
.PP
\fBReturns:\fP
.RS 4
false when an error occurred, true otherwise
.RE
.PP

.PP
Definition at line 138 of file kxmessages.cpp.
.PP
Referenced by sendMessageX().
.SS "bool KXMessages::sendMessageX (Display * disp, WId w, const char * msg_type, const \fBQString\fP & message)\fC [static]\fP"
.PP
\fBDeprecated\fP
.RS 4
This method is equivalent to \fBsendMessageX()\fP with obsolete = true. 
.RE
.PP

.PP
Definition at line 132 of file kxmessages.cpp.
.PP
References sendMessageX().
.SS "bool KXMessages::broadcastMessageX (Display * disp, const char * msg_type, const \fBQString\fP & message, int screen, bool obsolete)\fC [static]\fP"
.PP
Broadcasts the given message with the given message type. 
.PP
\fBParameters:\fP
.RS 4
\fIdisp\fP X11 connection which will be used instead of qt_x11display() 
.br
\fImsg_type\fP the type of the message 
.br
\fImessage\fP the message itself 
.br
\fIscreen\fP X11 screen to use, -1 for the default 
.br
\fIobsolete\fP always set to false (needed for backwards compatibility with KDE3.1 and older) 
.RE
.PP
\fBReturns:\fP
.RS 4
false when an error occurred, true otherwise
.RE
.PP

.PP
Definition at line 115 of file kxmessages.cpp.
.PP
Referenced by broadcastMessageX(), KStartupInfo::sendChangeX(), KStartupInfo::sendFinishX(), and KStartupInfo::sendStartupX().
.SS "bool KXMessages::broadcastMessageX (Display * disp, const char * msg_type, const \fBQString\fP & message)\fC [static]\fP"
.PP
\fBDeprecated\fP
.RS 4
This method is equivalent to \fBbroadcastMessageX()\fP with obsolete = true. 
.RE
.PP

.PP
Definition at line 109 of file kxmessages.cpp.
.PP
References broadcastMessageX().
.SS "void KXMessages::gotMessage (const \fBQString\fP & message)\fC [signal]\fP"
.PP
Emitted when a message was received. 
.PP
\fBParameters:\fP
.RS 4
\fImessage\fP the message that has been received
.RE
.PP


.SH "Author"
.PP 
Generated automatically by Doxygen for kdecore Library from the source code.
