\hypertarget{structxdg__surface__interface}{}\section{xdg\+\_\+surface\+\_\+interface Struct Reference}
\label{structxdg__surface__interface}\index{xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}}
\subsection*{Data Fields}
\begin{DoxyCompactItemize}
\item 
void($\ast$ \mbox{\hyperlink{structxdg__surface__interface_a6f8e7166689422677c87ecbb98adaaf9}{destroy}} )(struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource)
\begin{DoxyCompactList}\small\item\em destroy the xdg\+\_\+surface \end{DoxyCompactList}\item 
void($\ast$ \mbox{\hyperlink{structxdg__surface__interface_a0014de3da19530e53916e6332b580237}{get\+\_\+toplevel}} )(struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, uint32\+\_\+t id)
\begin{DoxyCompactList}\small\item\em assign the xdg\+\_\+toplevel surface role \end{DoxyCompactList}\item 
void($\ast$ \mbox{\hyperlink{structxdg__surface__interface_a7969599ddbf7d58eb19cecb3674a6427}{get\+\_\+popup}} )(struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, uint32\+\_\+t id, struct wl\+\_\+resource $\ast$parent, struct wl\+\_\+resource $\ast$positioner)
\begin{DoxyCompactList}\small\item\em assign the xdg\+\_\+popup surface role \end{DoxyCompactList}\item 
void($\ast$ \mbox{\hyperlink{structxdg__surface__interface_a2df712399207b562f44b5822d945355d}{set\+\_\+window\+\_\+geometry}} )(struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, int32\+\_\+t x, int32\+\_\+t y, int32\+\_\+t width, int32\+\_\+t height)
\begin{DoxyCompactList}\small\item\em set the new window geometry \end{DoxyCompactList}\item 
void($\ast$ \mbox{\hyperlink{structxdg__surface__interface_a58fa13041667722fea022feea70ec78a}{ack\+\_\+configure}} )(struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, uint32\+\_\+t serial)
\begin{DoxyCompactList}\small\item\em ack a configure event \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Field Documentation}
\mbox{\Hypertarget{structxdg__surface__interface_a6f8e7166689422677c87ecbb98adaaf9}\label{structxdg__surface__interface_a6f8e7166689422677c87ecbb98adaaf9}} 
\index{xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}!destroy@{destroy}}
\index{destroy@{destroy}!xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}}
\subsubsection{\texorpdfstring{destroy}{destroy}}
{\footnotesize\ttfamily void($\ast$ xdg\+\_\+surface\+\_\+interface\+::destroy) (struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource)}



destroy the xdg\+\_\+surface 

Destroy the xdg\+\_\+surface object. An xdg\+\_\+surface must only be destroyed after its role object has been destroyed. \mbox{\Hypertarget{structxdg__surface__interface_a0014de3da19530e53916e6332b580237}\label{structxdg__surface__interface_a0014de3da19530e53916e6332b580237}} 
\index{xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}!get\+\_\+toplevel@{get\+\_\+toplevel}}
\index{get\+\_\+toplevel@{get\+\_\+toplevel}!xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}}
\subsubsection{\texorpdfstring{get\+\_\+toplevel}{get\_toplevel}}
{\footnotesize\ttfamily void($\ast$ xdg\+\_\+surface\+\_\+interface\+::get\+\_\+toplevel) (struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, uint32\+\_\+t id)}



assign the xdg\+\_\+toplevel surface role 

This creates an xdg\+\_\+toplevel object for the given xdg\+\_\+surface and gives the associated wl\+\_\+surface the xdg\+\_\+toplevel role.

See the documentation of xdg\+\_\+toplevel for more details about what an xdg\+\_\+toplevel is and how it is used. \mbox{\Hypertarget{structxdg__surface__interface_a7969599ddbf7d58eb19cecb3674a6427}\label{structxdg__surface__interface_a7969599ddbf7d58eb19cecb3674a6427}} 
\index{xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}!get\+\_\+popup@{get\+\_\+popup}}
\index{get\+\_\+popup@{get\+\_\+popup}!xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}}
\subsubsection{\texorpdfstring{get\+\_\+popup}{get\_popup}}
{\footnotesize\ttfamily void($\ast$ xdg\+\_\+surface\+\_\+interface\+::get\+\_\+popup) (struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, uint32\+\_\+t id, struct wl\+\_\+resource $\ast$parent, struct wl\+\_\+resource $\ast$positioner)}



assign the xdg\+\_\+popup surface role 

This creates an xdg\+\_\+popup object for the given xdg\+\_\+surface and gives the associated wl\+\_\+surface the xdg\+\_\+popup role.

If null is passed as a parent, a parent surface must be specified using some other protocol, before committing the initial state.

See the documentation of xdg\+\_\+popup for more details about what an xdg\+\_\+popup is and how it is used. \mbox{\Hypertarget{structxdg__surface__interface_a2df712399207b562f44b5822d945355d}\label{structxdg__surface__interface_a2df712399207b562f44b5822d945355d}} 
\index{xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}!set\+\_\+window\+\_\+geometry@{set\+\_\+window\+\_\+geometry}}
\index{set\+\_\+window\+\_\+geometry@{set\+\_\+window\+\_\+geometry}!xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}}
\subsubsection{\texorpdfstring{set\+\_\+window\+\_\+geometry}{set\_window\_geometry}}
{\footnotesize\ttfamily void($\ast$ xdg\+\_\+surface\+\_\+interface\+::set\+\_\+window\+\_\+geometry) (struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, int32\+\_\+t x, int32\+\_\+t y, int32\+\_\+t width, int32\+\_\+t height)}



set the new window geometry 

The window geometry of a surface is its \char`\"{}visible bounds\char`\"{} from the user\textquotesingle{}s perspective. Client-\/side decorations often have invisible portions like drop-\/shadows which should be ignored for the purposes of aligning, placing and constraining windows.

The window geometry is double buffered, and will be applied at the time wl\+\_\+surface.\+commit of the corresponding wl\+\_\+surface is called.

When maintaining a position, the compositor should treat the (x, y) coordinate of the window geometry as the top left corner of the window. A client changing the (x, y) window geometry coordinate should in general not alter the position of the window.

Once the window geometry of the surface is set, it is not possible to unset it, and it will remain the same until set\+\_\+window\+\_\+geometry is called again, even if a new subsurface or buffer is attached.

If never set, the value is the full bounds of the surface, including any subsurfaces. This updates dynamically on every commit. This unset is meant for extremely simple clients.

The arguments are given in the surface-\/local coordinate space of the wl\+\_\+surface associated with this xdg\+\_\+surface.

The width and height must be greater than zero. Setting an invalid size will raise an error. When applied, the effective window geometry will be the set window geometry clamped to the bounding rectangle of the combined geometry of the surface of the xdg\+\_\+surface and the associated subsurfaces. \mbox{\Hypertarget{structxdg__surface__interface_a58fa13041667722fea022feea70ec78a}\label{structxdg__surface__interface_a58fa13041667722fea022feea70ec78a}} 
\index{xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}!ack\+\_\+configure@{ack\+\_\+configure}}
\index{ack\+\_\+configure@{ack\+\_\+configure}!xdg\+\_\+surface\+\_\+interface@{xdg\+\_\+surface\+\_\+interface}}
\subsubsection{\texorpdfstring{ack\+\_\+configure}{ack\_configure}}
{\footnotesize\ttfamily void($\ast$ xdg\+\_\+surface\+\_\+interface\+::ack\+\_\+configure) (struct wl\+\_\+client $\ast$client, struct wl\+\_\+resource $\ast$resource, uint32\+\_\+t serial)}



ack a configure event 

When a configure event is received, if a client commits the surface in response to the configure event, then the client must make an ack\+\_\+configure request sometime before the commit request, passing along the serial of the configure event.

For instance, for toplevel surfaces the compositor might use this information to move a surface to the top left only when the client has drawn itself for the maximized or fullscreen state.

If the client receives multiple configure events before it can respond to one, it only has to ack the last configure event.

A client is not required to commit immediately after sending an ack\+\_\+configure request -\/ it may even ack\+\_\+configure several times before its next surface commit.

A client may send multiple ack\+\_\+configure requests before committing, but only the last request sent before a commit indicates which configure event the client really is responding to. 
\begin{DoxyParams}{Parameters}
{\em serial} & the serial from the configure event \\
\hline
\end{DoxyParams}
