\hypertarget{structxdg__shell__listener}{}\doxysection{xdg\+\_\+shell\+\_\+listener Struct Reference}
\label{structxdg__shell__listener}\index{xdg\_shell\_listener@{xdg\_shell\_listener}}


Create desktop-\/style surfaces.  




{\ttfamily \#include $<$xdg-\/shell-\/client-\/protocol.\+h$>$}

\doxysubsection*{Data Fields}
\begin{DoxyCompactItemize}
\item 
void($\ast$ \mbox{\hyperlink{structxdg__shell__listener_a4cfcb0e8165a3a77ca03d69cca8e6cf9}{ping}} )(void $\ast$data, struct xdg\+\_\+shell $\ast$xdg\+\_\+shell, uint32\+\_\+t serial)
\begin{DoxyCompactList}\small\item\em Check if the client is alive. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
Create desktop-\/style surfaces. 

xdg\+\_\+shell allows clients to turn a wl\+\_\+surface into a \char`\"{}real window\char`\"{} which can be dragged, resized, stacked, and moved around by the user. Everything about this interface is suited towards traditional desktop environments. 

\doxysubsection{Field Documentation}
\mbox{\Hypertarget{structxdg__shell__listener_a4cfcb0e8165a3a77ca03d69cca8e6cf9}\label{structxdg__shell__listener_a4cfcb0e8165a3a77ca03d69cca8e6cf9}} 
\index{xdg\_shell\_listener@{xdg\_shell\_listener}!ping@{ping}}
\index{ping@{ping}!xdg\_shell\_listener@{xdg\_shell\_listener}}
\doxysubsubsection{\texorpdfstring{ping}{ping}}
{\footnotesize\ttfamily void($\ast$ xdg\+\_\+shell\+\_\+listener\+::ping) (void $\ast$data, struct xdg\+\_\+shell $\ast$xdg\+\_\+shell, uint32\+\_\+t serial)}



Check if the client is alive. 

The ping event asks the client if it\textquotesingle{}s still alive. Pass the serial specified in the event back to the compositor by sending a \char`\"{}pong\char`\"{} request back with the specified serial.

Compositors can use this to determine if the client is still alive. It\textquotesingle{}s unspecified what will happen if the client doesn\textquotesingle{}t respond to the ping request, or in what timeframe. Clients should try to respond in a reasonable amount of time.

A compositor is free to ping in any way it wants, but a client must always respond to any xdg\+\_\+shell object it created.


\begin{DoxyParams}{Parameters}
{\em serial} & Pass this to the pong request \\
\hline
\end{DoxyParams}
