gtkdialog.html

来自「该压缩包包含了GTK+的大量API函数」· HTML 代码 · 共 661 行

HTML
661 行
字号 
<HTML><HEAD><TITLE>GtkDialog</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkData"HREF="gtkdata.html"><LINKREL="NEXT"TITLE="GtkDrawingArea"HREF="gtkdrawingarea.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkdata.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>&#60;&#60;&#60; Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkdrawingarea.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page &#62;&#62;&#62;</B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKDIALOG">GtkDialog</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN24176"></A><H2>Name</H2>GtkDialog&nbsp;--&nbsp;create popup windows.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN24179"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS">&#13;#include &lt;gtk/gtk.h&gt;struct      <AHREF="gtkdialog.html#GTKDIALOG-STRUCT">GtkDialog</A>;struct      <AHREF="gtkdialog.html#GTKDIALOGBUTTON">GtkDialogButton</A>;<AHREF="gtkwidget.html">GtkWidget</A>*  <AHREF="gtkdialog.html#GTK-DIALOG-NEW">gtk_dialog_new</A>                  (void);&#13;</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN24186"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS">&#13;  <AHREF="gtkobject.html">GtkObject</A>   +----<AHREF="gtkwidget.html">GtkWidget</A>         +----<AHREF="gtkcontainer.html">GtkContainer</A>               +----<AHREF="gtkbin.html">GtkBin</A>                     +----<AHREF="gtkwindow.html">GtkWindow</A>                           +----GtkDialog</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN24194"></A><H2>Description</H2><P>Dialog boxes are a convenient way to prompt the user for a small amount ofinput, eg. to displaya message, ask a question, or anything else that does not require extensiveeffort on the user's part.</P><P>Gtk+ treats a dialog as a window split horizontally. The top section is a<AHREF="gtkvbox.html">GtkVBox</A>, and is where widgets such as a <AHREF="gtklabel.html">GtkLabel</A> or a <AHREF="gtkentry.html">GtkEntry</A> should bepacked. The second area is known as the <TTCLASS="STRUCTFIELD"><I>action_area</I></TT>. This is generally usedfor packing buttons into the dialog which may perform functions such as cancel, ok, or apply. The twoareas are separated by a <AHREF="gtkhseparator.html">GtkHSeparator</A>.</P><P><AHREF="gtkdialog.html">GtkDialog</A> boxes are created with a call to <AHREF="gtkdialog.html#GTK-DIALOG-NEW">gtk_dialog_new</A>().</P><P>If 'dialog' is a newly created dialog, the two primary areas of the window can be accessed as GTK_DIALOG(dialog)-&#62;vbox and GTK_DIALOG(dialog)-&#62;action_area,as can be seen from the example, below.</P><P>A 'modal' dialog (that is, one which freezes the rest of the applicationfrom user input), can be created by calling <AHREF="gtkwindow.html#GTK-WINDOW-SET-MODAL">gtk_window_set_modal</A>() on the dialog. Use theGTK_WINDOW() macro to cast the widget returned from <AHREF="gtkdialog.html#GTK-DIALOG-NEW">gtk_dialog_new</A>() into a<AHREF="gtkwindow.html">GtkWindow</A>.</P><P><DIVCLASS="EXAMPLE"><ANAME="AEN24213"></A><P><B>Example 1. Using a <AHREF="gtkdialog.html">GtkDialog</A> to keep the user informed.</B></P><TABLEBORDER="0"BGCOLOR="#D8F8D8"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">&#13;/* Function to open a dialog box displaying the message provided. */void quick_message(<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *message) {   <AHREF="gtkwidget.html">GtkWidget</A> *dialog, *label, *okay_button;      /* Create the widgets */      dialog = <AHREF="gtkdialog.html#GTK-DIALOG-NEW">gtk_dialog_new</A>();   label = gtk_label_new (message);   okay_button = gtk_button_new_with_label("Okay");      /* Ensure that the dialog box is destroyed when the user clicks ok. */      gtk_signal_connect_object (GTK_OBJECT (okay_button), "clicked",                              GTK_SIGNAL_FUNC (gtk_widget_destroy), dialog);   gtk_container_add (GTK_CONTAINER (GTK_DIALOG(dialog)-&#62;action_area),                      okay_button);   /* Add the label, and show everything we've added to the dialog. */   gtk_container_add (GTK_CONTAINER (GTK_DIALOG(dialog)-&#62;vbox),                      label);   gtk_widget_show_all (dialog);}&#13;</PRE></TD></TR></TABLE></DIV></P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN24220"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN24222"></A><H3><ANAME="GTKDIALOG-STRUCT"></A>struct GtkDialog</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkDialog;</PRE></TD></TR></TABLE><P><TTCLASS="STRUCTFIELD"><I>window</I></TT> is a <AHREF="gtkwindow.html">GtkWindow</A>, but should not bemodified directly, (use the functions provided, such as<AHREF="gtkwindow.html#GTK-WINDOW-SET-TITLE">gtk_window_set_title</A>(). See the <AHREF="gtkwindow.html">GtkWindow</A> section for more).</P><P><TTCLASS="STRUCTFIELD"><I>vbox</I></TT> is a <AHREF="gtkvbox.html">GtkVBox</A> - the main part of the dialog box.</P><P><TTCLASS="STRUCTFIELD"><I>action_area</I></TT> is a <AHREF="gtkhbox.html">GtkHBox</A> packed below the dividing <AHREF="gtkhseparator.html">GtkHSeparator</A> in the dialog. It is treated exactly the same as any other <AHREF="gtkhbox.html">GtkHBox</A>.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN24239"></A><H3><ANAME="GTKDIALOGBUTTON"></A>struct GtkDialogButton</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkDialogButton;</PRE></TD></TR></TABLE><P>Deprecated.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN24244"></A><H3><ANAME="GTK-DIALOG-NEW"></A>gtk_dialog_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>*  gtk_dialog_new                  (void);</PRE></TD></TR></TABLE><P>Creates a new dialog box. Widgets should not be packed into this <AHREF="gtkwindow.html">GtkWindow</A>directly, but into the vbox and action_area, as described above. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN24251"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkwidget.html">GtkWidget</A> - the newly created dialog box.&#13;</TD></TR></TBODY></TABLE><P></P></DIV></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN24261"></A><H2>See Also</H2><P><P></P><DIVCLASS="VARIABLELIST"><DL><DT><AHREF="gtkvbox.html">GtkVBox</A></DT><DD><P>Pack widgets vertically.</P></DD><DT><AHREF="gtkwindow.html">GtkWindow</A></DT><DD><P>Alter the properties of your dialog box.</P></DD><DT><AHREF="gtkbutton.html">GtkButton</A></DT><DD><P>Add them to the <TTCLASS="STRUCTFIELD"><I>action_area</I></TT> to get aresponse from the user.</P></DD></DL></DIV></P></DIV><DIVCLASS="NAVFOOTER"><BRCLEAR="all"><BR><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkdata.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>&#60;&#60;&#60; Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkdrawingarea.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page &#62;&#62;&#62;</B></FONT></A></TD></TR><TR><TDCOLSPAN="2"ALIGN="left"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkData</B></FONT></TD><TDCOLSPAN="2"ALIGN="right"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkDrawingArea</B></FONT></TD></TR></TABLE></DIV></BODY></HTML>

gtkdialog.html - 源码说明

本页面展示了「该压缩包包含了GTK+的大量API函数」中的 gtkdialog.html 源码文件，采用 HTML 编程语言编写，共 661 行代码。您可以在线阅读完整代码内容，也可以返回资源详情页下载完整源码包进行本地学习和开发。

虫虫开发者社区收录了大量与GTK+相关的技术资源，包括源代码、技术文档、电路图等，是电子工程师和嵌入式开发者的专业学习平台。

⌨️ 快捷键说明

复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?