📄 gtkaccellabel.html
字号:
<HTML><HEAD><TITLE>GtkAccelLabel</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="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="NEXT"TITLE="GtkAdjustment"HREF="gtkadjustment.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="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< 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="gtkadjustment.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKACCELLABEL">GtkAccelLabel</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN12696"></A><H2>Name</H2>GtkAccelLabel -- a label which displays an accelerator key on the right of the text.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN12699"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkaccellabel.html#GTKACCELLABEL-STRUCT">GtkAccelLabel</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkaccellabel.html#GTK-ACCEL-LABEL-NEW">gtk_accel_label_new</A> (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *string);void <AHREF="gtkaccellabel.html#GTK-ACCEL-LABEL-SET-ACCEL-WIDGET">gtk_accel_label_set_accel_widget</A> (<AHREF="gtkaccellabel.html">GtkAccelLabel</A> *accel_label, <AHREF="gtkwidget.html">GtkWidget</A> *accel_widget);<AHREF=../glib/glib-basic-types.html#GUINT>guint</A> <AHREF="gtkaccellabel.html#GTK-ACCEL-LABEL-GET-ACCEL-WIDTH">gtk_accel_label_get_accel_width</A> (<AHREF="gtkaccellabel.html">GtkAccelLabel</A> *accel_label);<AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> <AHREF="gtkaccellabel.html#GTK-ACCEL-LABEL-REFETCH">gtk_accel_label_refetch</A> (<AHREF="gtkaccellabel.html">GtkAccelLabel</A> *accel_label); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12715"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkmisc.html">GtkMisc</A> +----<AHREF="gtklabel.html">GtkLabel</A> +----GtkAccelLabel</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12722"></A><H2>Args</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkaccellabel.html#GTKACCELLABEL--ACCEL-WIDGET">accel-widget</A>" <AHREF="gtkwidget.html">GtkWidget</A> : Read / Write</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12727"></A><H2>Description</H2><P>The <AHREF="gtkaccellabel.html">GtkAccelLabel</A> widget is a subclass of <AHREF="gtklabel.html">GtkLabel</A> that also displays anaccelerator key on the right of the label text, e.g. 'Ctl+S'.It is commonly used in menus to show the keyboard short-cuts for commands.</P><P>The accelerator key to display is not set explicitly.Instead, the <AHREF="gtkaccellabel.html">GtkAccelLabel</A> displays the accelerators which have been added toa particular widget. This widget is set by calling<AHREF="gtkaccellabel.html#GTK-ACCEL-LABEL-SET-ACCEL-WIDGET">gtk_accel_label_set_accel_widget</A>().</P><P>For example, a <AHREF="gtkmenuitem.html">GtkMenuItem</A> widget may have an accelerator added to emit the"activate" signal when the 'Ctl+S' key combination is pressed.A <AHREF="gtkaccellabel.html">GtkAccelLabel</A> is created and added to the <AHREF="gtkmenuitem.html">GtkMenuItem</A>, and<AHREF="gtkaccellabel.html#GTK-ACCEL-LABEL-SET-ACCEL-WIDGET">gtk_accel_label_set_accel_widget</A>() is called with the <AHREF="gtkmenuitem.html">GtkMenuItem</A> as thesecond argument. The <AHREF="gtkaccellabel.html">GtkAccelLabel</A> will now display 'Ctl+S' after its label.</P><P>Note that creating a <AHREF="gtkmenuitem.html">GtkMenuItem</A> with <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-NEW-WITH-LABEL">gtk_menu_item_new_with_label</A>() (orone of the similar functions for <AHREF="gtkcheckmenuitem.html">GtkCheckMenuItem</A> and <AHREF="gtkradiomenuitem.html">GtkRadioMenuItem</A>)automatically adds a <AHREF="gtkaccellabel.html">GtkAccelLabel</A> to the <AHREF="gtkmenuitem.html">GtkMenuItem</A> and calls<AHREF="gtkaccellabel.html#GTK-ACCEL-LABEL-SET-ACCEL-WIDGET">gtk_accel_label_set_accel_widget</A>() to set it up for you.</P><P>A <AHREF="gtkaccellabel.html">GtkAccelLabel</A> will only display accelerators which have GTK_ACCEL_VISIBLEset (see <AHREF="gtk-standard-enumerations.html#GTKACCELFLAGS">GtkAccelFlags</A>).A <AHREF="gtkaccellabel.html">GtkAccelLabel</A> can display multiple accelerators and even signal names,though it is almost always used to display just one accelerator key.</P><DIVCLASS="EXAMPLE"><ANAME="AEN12754"></A><P><B>Example 1. Creating a simple menu item with an accelerator key.</B></P><TABLEBORDER="0"BGCOLOR="#D8F8D8"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"> GtkWidget *save_item; GtkAccelGroup *accel_group; /* Create a <AHREF="gtk-keyboard-accelerators.html#GTKACCELGROUP">GtkAccelGroup</A> and add it to the window. */ accel_group = <AHREF="gtk-keyboard-accelerators.html#GTK-ACCEL-GROUP-NEW">gtk_accel_group_new</A>(); gtk_window_add_accel_group (GTK_WINDOW (window), accel_group); /* Create the menu item using the convenience function. */ save_item = gtk_menu_item_new_with_label ("Save"); gtk_widget_show (save_item); gtk_container_add (GTK_CONTAINER (menu), save_item); /* Now add the accelerator to the <AHREF="gtkmenuitem.html">GtkMenuItem</A>. Note that since we called <AHREF="gtkmenuitem.html#GTK-MENU-ITEM-NEW-WITH-LABEL">gtk_menu_item_new_with_label</A>() to create the <AHREF="gtkmenuitem.html">GtkMenuItem</A> the <AHREF="gtkaccellabel.html">GtkAccelLabel</A> is automatically set up to display the <AHREF="gtkmenuitem.html">GtkMenuItem</A> accelerators. We just need to make sure we use GTK_ACCEL_VISIBLE here. */ gtk_widget_add_accelerator (save_item, "activate", accel_group, GDK_s, GDK_CONTROL_MASK, GTK_ACCEL_VISIBLE);</PRE></TD></TR></TABLE></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12764"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN12766"></A><H3><ANAME="GTKACCELLABEL-STRUCT"></A>struct GtkAccelLabel</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkAccelLabel;</PRE></TD></TR></TABLE><P>The <AHREF="gtkaccellabel.html#GTKACCELLABEL-STRUCT">GtkAccelLabel</A> struct contains private data only, andshould be accessed using the functions below.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN12772"></A><H3><ANAME="GTK-ACCEL-LABEL-NEW"></A>gtk_accel_label_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_accel_label_new (const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *string);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkaccellabel.html">GtkAccelLabel</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN12780"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>string</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the label string.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new <AHREF="gtkaccellabel.html">GtkAccelLabel</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN12794"></A><H3><ANAME="GTK-ACCEL-LABEL-SET-ACCEL-WIDGET"></A>gtk_accel_label_set_accel_widget ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_accel_label_set_accel_widget (<AHREF="gtkaccellabel.html">GtkAccelLabel</A> *accel_label, <AHREF="gtkwidget.html">GtkWidget</A> *accel_widget);</PRE></TD></TR></TABLE><P>Sets the widget whose accelerators are to be shown.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN12801"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>accel_label</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkaccellabel.html">GtkAccelLabel</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>accel_widget</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the widget whose accelerators are to be displayed. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN12815"></A><H3><ANAME="GTK-ACCEL-LABEL-GET-ACCEL-WIDTH"></A>gtk_accel_label_get_accel_width ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF=../glib/glib-basic-types.html#GUINT>guint</A> gtk_accel_label_get_accel_width (<AHREF="gtkaccellabel.html">GtkAccelLabel</A> *accel_label);</PRE></TD></TR></TABLE><P>Returns the width needed to display the accelerator key(s).This is used by menus to align all of the <AHREF="gtkmenuitem.html">GtkMenuItem</A> widgets, and shouldn'tbe needed by applications.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN12823"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>accel_label</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkaccellabel.html">GtkAccelLabel</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP"> </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN12837"></A><H3><ANAME="GTK-ACCEL-LABEL-REFETCH"></A>gtk_accel_label_refetch ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> gtk_accel_label_refetch (<AHREF="gtkaccellabel.html">GtkAccelLabel</A> *accel_label);</PRE></TD></TR></TABLE><P>Recreates the string representing the accelerator keys.This should not be needed since the string is automatically updated wheneveraccelerators are added or removed from the associated widget.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN12844"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>accel_label</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkaccellabel.html">GtkAccelLabel</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">always returns FALSE. </TD></TR></TBODY></TABLE><P></P></DIV></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12858"></A><H2>Args</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT><ANAME="GTKACCELLABEL--ACCEL-WIDGET"></A>"<TTCLASS="LITERAL">accel-widget</TT>" (<AHREF="gtkwidget.html">GtkWidget</A> : Read / Write)</DT><DD><P></P></DD></DL></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12868"></A><H2>See Also</H2><P><P></P><DIVCLASS="VARIABLELIST"><DL><DT><AHREF="gtk-keyboard-accelerators.html">Keyboard Accelerators</A></DT><DD><P>installing and using keyboard short-cuts.</P></DD><DT><AHREF="gtkitemfactory.html">GtkItemFactory</A></DT><DD><P>an easier way to create menus.</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="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< 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="gtkadjustment.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR><TR><TDCOLSPAN="2"ALIGN="left"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GTK+ Widgets and Objects</B></FONT></TD><TDCOLSPAN="2"ALIGN="right"><FONTCOLOR="#FFFFFF"SIZE="3"><B>GtkAdjustment</B></FONT></TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -