sec-gdkwindow.html

GTK+_ Gnome Application Development

              <span class="STRUCTNAME">GDK_WINDOW_FOREIGN</span>
              identifies a wrapper around a window not created by
              GDK.&#13;
            </p>
          </li>
        </ul>
        <p>
          Only <span class="STRUCTNAME">GDK_WINDOW_TOPLEVEL</span>,
          <span class="STRUCTNAME">GDK_WINDOW_CHILD</span>, <span
          class="STRUCTNAME">GDK_WINDOW_TEMP</span>, and <span
          class="STRUCTNAME">GDK_WINDOW_DIALOG</span> are valid for
          <tt class="FUNCTION">gdk_window_new()</tt>. Library users
          may not create a <span class="STRUCTNAME">
          GDK_WINDOW_ROOT</span>. Pixmaps (<span class=
          "STRUCTNAME">GDK_WINDOW_PIXMAP</span>) are created with
          <tt class="FUNCTION">gdk_pixmap_new()</tt>. Foreign
          windows (<span class=
          "STRUCTNAME">GDK_WINDOW_FOREIGN</span>) are X windows
          created outside of GDK and wrapped using <tt class= 
          "FUNCTION">gdk_window_foreign_new()</tt> (declared in <tt
          class="FILENAME">gdk/gdkx.h</tt>, since you will only
          need this function if you are using Xlib directly).
        </p>
        <p>
          The <span class="STRUCTNAME">cursor</span> field
          specifies the mouse pointer (cursor) to use in this
          window; see <a href="sec-gdkcursor.html">the section
          called <i>The Mouse Pointer</i></a> for information about
          cursors.
        </p>
        <p>
          The "class hint" is described in <a href= 
          "z94.html#SEC-CLASSHINT">the section called <i>Setting
          Window Class Hints</i> in the chapter called <i>The Main
          Window: <tt class="CLASSNAME">GnomeApp</tt></i></a>. When
          writing widgets, you will not usually set the class hint.
          It is only relevant for toplevel windows; GTK+ provides
          <tt class="FUNCTION">gtk_window_set_wmclass()</tt> so
          application authors can set it to something sensible.
        </p>
        <p>
          The last field in <span class="STRUCTNAME">
          GdkWindowAttr</span> determines whether the window is
          "override redirect." Normally, window managers intercept
          all requests to show, hide, move, or resize a toplevel
          window. They can then redirect or cancel these requests,
          to force windows to behave according to the window
          manager's layout policy. You can override this behavior
          by setting <span class="STRUCTNAME">
          override_redirect</span> to <span class="STRUCTNAME">
          TRUE</span>. Since window managers can not move windows
          with this flag set, they will normally not put a title
          bar or other decorations on them. Note that all <span
          class="STRUCTNAME">GDK_WINDOW_TEMP</span> windows use
          <span class="STRUCTNAME">TRUE</span> for this field;
          recall that <span class="STRUCTNAME">
          GDK_WINDOW_TEMP</span> is often used for popup menus,
          which are not controlled by the window manager.
        </p>
        <p>
          Typically you should not change the <span class= 
          "STRUCTNAME">override_redirect</span> field; the default
          is almost always right, if you specify the correct <span
          class="STRUCTNAME">GdkWindowType</span>. However, there
          are some exceptions; the Gnome panel application sets
          this field, for example.
        </p>
        <div class="TABLE">
          <a name="TAB-GDKWINDOWATTR"></a>
          <p>
            <b>Table 1. <span class="STRUCTNAME">
            GdkWindowAttr</span> Fields</b>
          </p>
          <table border="1" bgcolor="#E0E0E0" cellspacing="0"
          cellpadding="4" class="CALSTABLE">
            <tr>
              <th align="LEFT" valign="TOP">
                Field
              </th>
              <th align="LEFT" valign="TOP">
                Type
              </th>
              <th align="LEFT" valign="TOP">
                Flag
              </th>
              <th align="LEFT" valign="TOP">
                Default Value
              </th>
              <th align="LEFT" valign="TOP">
                Purpose
              </th>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">title</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gchar*</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_TITLE</span>
              </td>
              <td align="LEFT" valign="TOP">
                Program Name
              </td>
              <td align="LEFT" valign="TOP">
                The window's title
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">event_mask</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gint</span>
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                Events to receive on this window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">x</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gint16</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_X</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">0</span>
              </td>
              <td align="LEFT" valign="TOP">
                X position relative to parent window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">y</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gint16</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_Y</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">0</span>
              </td>
              <td align="LEFT" valign="TOP">
                Y position relative to parent window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">width</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gint16</span>
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                Width of window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">height</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gint16</span>
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                Height of window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">wclass</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GdkWindowClass</span>
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_INPUT_ONLY</span> vs.
                <span class="STRUCTNAME">GDK_INPUT_OUTPUT</span>
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">visual</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GdkVisual*</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_VISUAL</span>
              </td>
              <td align="LEFT" valign="TOP">
                X's "default visual"
              </td>
              <td align="LEFT" valign="TOP">
                Visual for this window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">colormap</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GdkColormap*</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_COLORMAP</span>
              </td>
              <td align="LEFT" valign="TOP">
                X's "default colormap" [PD]footnote!
              </td>
              <td align="LEFT" valign="TOP">
                Colormap for this window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">window_type</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GdkWindowType</span>
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                none
              </td>
              <td align="LEFT" valign="TOP">
                Window type (see text)
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">cursor</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GdkCursor*</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_CURSOR</span>
              </td>
              <td align="LEFT" valign="TOP">
                Parent window's cursor
              </td>
              <td align="LEFT" valign="TOP">
                Mouse pointer for this window
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">wmclass_name</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gchar*</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_WMCLASS</span>
              </td>
              <td align="LEFT" valign="TOP">
                none (doesn't set hint)
              </td>
              <td align="LEFT" valign="TOP">
                Set the "name" part of the class hint (see text)
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">wmclass_class</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gchar*</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_WMCLASS</span>
              </td>
              <td align="LEFT" valign="TOP">
                none (doesn't set hint)
              </td>
              <td align="LEFT" valign="TOP">
                Set the "class" part of the class hint (see text)
              </td>
            </tr>
            <tr>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">override_redirect</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">gboolean</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">GDK_WA_NOREDIR</span>
              </td>
              <td align="LEFT" valign="TOP">
                <span class="STRUCTNAME">FALSE</span> [PD]
                footnote!
              </td>
              <td align="LEFT" valign="TOP">
                Make the window "override redirect" (see text)
              </td>
            </tr>
          </table>
        </div>
      </div>
    </div>
    <div class="NAVFOOTER">
      <br>
      <br>
      <table width="100%" border="0" bgcolor="#ffffff" cellpadding= 
      "1" cellspacing="0">
        <tr>
          <td width="25%" bgcolor="#ffffff" align="left">
            <a href="cha-gdk.html"><font color="#0000ff" size="2">
            <b>&lt;&lt;&lt; Previous</b></font></a>
          </td>
          <td width="25%" colspan="2" bgcolor="#ffffff" align= 
          "center">
            <font color="#0000ff" size="2"><b><a href="ggad.html">
            <font color="#0000ff" size="2"><b>
            Home</b></font></a></b></font>
          </td>
          <td width="25%" bgcolor="#ffffff" align="right">
            <a href="sec-gdkvisual.html"><font color="#0000ff"
            size="2"><b>Next &gt;&gt;&gt;</b></font></a>
          </td>
        </tr>
        <tr>
          <td colspan="2" align="left">
            <font color="#000000" size="2"><b>GDK Basics</b></font>
          </td>
          <td colspan="2" align="right">
            <font color="#000000" size="2"><b>Visuals and
            Colormaps</b></font>
          </td>
        </tr>
      </table>
    </div>
  </body>
</html>