gtk-sharp2.12.0.0Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details.A widget that displays a small to medium amount of text
This widget displays a small to medium amount of text, it is
the widget used by other widgets, such as and for
displaying text.
Labels may contain mnemonics; mnemonics are underlined
characters in the label, used for keyboard navigation. To
provide the mnemonic, put an underscore before the mnemonic
character, such as "_File".
Gtk.MiscMethodSystem.VoidSelects a range of characters in the label, if the label is selectable.
start offset (in characters not bytes)
end offset (in characters not bytes)
Selects a range of characters in the label, if the label
is selectable. See . If the
label is not selectable, this function has no effect. If
or
are -1, then the end of the
label will be substituted.
ConstructorInternal constructor
Pointer to the C object.
This is an internal constructor, and should not be used by user code.Constructor
Creates a new label with the given text inside it. You can
pass to get an empty label
widget.
The text of the label. Pass for no text.
Creates a new label with the given text inside it. You can
pass to get an empty label
widget. If contains an underscore,
the property is
automatically set to .
PropertySystem.StringSets the text of the label
Sets the text of the label. If characters in
are preceded by an underscore, they are
underlined indicating that they represent a keyboard
accelerator called a mnemonic. The mnemonic key can be
used to activate another widget, chosen automatically, or
explicitly using .
To be added.PropertySystem.StringParses str which is marked up with the Pango text markup languagea GtkLabel
Parses which is marked up with the
Pango text markup language, setting the text of the label and
attribute list based on the parse results.
PropertySystem.BooleanToggles line wrapping within the GtkLabel widget. if the lines of the label are automatically wrapped.PropertySystem.StringThe text within the widget.a
When setting the text within the widget, it overwrites any text that was there before.
PropertyPango.LayoutGets the used to display the label. the for this label
Gets the used to display the label. The layout
is useful to e.g. convert text positions to pixel
positions, in combination with . The returned layout
is owned by the label so need not be freed by the caller.
PropertySystem.String
Parses which is marked up with the
Pango text markup language, setting the text of the label and
attribute list based on the parse results.
a new label widget
Parses which is marked up with the
Pango text markup language, setting the text of the label and
attribute list based on the parse results. If characters
in the string are preceded by an underscore, they are underlined
indicating that they represent a keyboard accelerator
called a mnemonic.
The mnemonic key can be used to activate another widget,
chosen automatically, or explicitly using .
PropertySystem.BooleanToggle whether or not the label allow the user to select text from the label, for copy-and-paste. if the label is selectable, and
if not.
GLib.Property("selectable")PropertyGtk.JustificationThe alignment of the lines in the text of the label relative to each otherThe justification of the label
Sets the alignment of the lines in the text of the label
relative to each other. is the default value
when the widget is first created with . If you instead want to set the
alignment of the label as a whole, set instead. This has no effect
on labels containing only a single line.
GLib.Property("justify")PropertySystem.Int32The current position of the insertion cursor in characters.The current position of the insertion cursor in charactersGLib.Property("cursor-position")PropertySystem.Int32The position of the opposite end of the selection from the cursor in characters.The position of the opposite end of the selection from the cursor in characters.GLib.Property("selection-bound")PropertyGtk.WidgetThe widget to be activated when the label's mnemonic key is pressed.The widget to be activated when the label's mnemonic key is pressed.GLib.Property("mnemonic-widget")PropertySystem.StringThe text from a label widget including any embedded underlines indicating mnemonics and Pango markup.The text of the label widget.You can include markup tags to change your text appearance. See for more information.GLib.Property("label")PropertySystem.StringA string with _ characters in positions correspond to characters in the text to underline.To be added.GLib.Property("pattern")PropertySystem.UInt32The mnemonic accelerator key for this label.The mnemonic accelerator key for this label.GLib.Property("mnemonic-keyval")PropertySystem.BooleanWhether lines should be wrapped if the text becomes too wide.whether lines should be wrappedGLib.Property("wrap")PropertySystem.Boolean
Whether an underline in the text indicates the next
character should be used for the mnemonic accelerator key.
Whether an underline in the text indicates the next
character should be used for the mnemonic accelerator key.
GLib.Property("use-underline")PropertySystem.BooleanWhether the label's text is interpreted as marked up with the Pango text markup language ( more information at http://developer.gnome.org/doc/API/2.0/pango/PangoMarkupFormat.html ). if the label's text should be parsed for markupHere are a few examples of the markup you can use:
TagDescription<b>Bold<big>Makes font relatively larger<i>Italic<s>Strikethrough<sub>Subscript<sup>Superscript<small>Makes font relatively smaller<tt>Monospace font<u>Underline
Gtk.Label label = new Gtk.Label();
label.LabelProp = "The brown <u>fox</u> etc. and the <big>lazy</big> dog";
label.UseMarkup = true;
GLib.Property("use-markup")PropertyPango.AttrListThe attribute list set on the label.the attribute list set on the label
This function does not reflect attributes that come from
the labels markup (see ). If you
want to get the effective attributes for the label, use
on the label's
property.
GLib.Property("attributes")EventGtk.MoveCursorHandlerEmitted when the cursor is moved.GLib.Signal("move_cursor")EventGtk.PopulatePopupHandlerEmitted when a right-click pop-up menu is displayedGLib.Signal("populate_popup")EventSystem.EventHandlerEmitted when text is copied to the clipboard.GLib.Signal("copy_clipboard")PropertyGLib.GTypeGType Property.a Returns the native value for .MethodSystem.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.MethodSystem.VoidDefault handler for the event.
a Override this method in a subclass to provide a default handler for the event.MethodSystem.VoidDefault handler for the event.
a
a
a Override this method in a subclass to provide a default handler for the event.ConstructorInternal constructor
a This is not typically used by C# code.System.ObsoleteMethodGtk.LabelBasic constructor.
a a ConstructorCreates a new without text.MethodSystem.UInt32Deprecated.
a a
Checks the string passed as the parameter for underscores,
and then underlines the characters following the
underscores. It will take the first underlined character in
a label and return it as a lower-case accelerator key,
e.g. _Save will return the accelerator key value for "s".
MethodSystem.VoidDeprecated; do not use in new code.
a Gets the current string of text within the Label
object and writes it to . It does not make a copy of this
string so you must not write to it.PropertySystem.DoubleTo be addeda To be addedGLib.Property("angle")PropertySystem.BooleanTo be addeda To be addedGLib.Property("single-line-mode")PropertyPango.EllipsizeModeTo be addeda To be addedGLib.Property("ellipsize")PropertySystem.Int32To be addeda To be addedGLib.Property("width-chars")PropertySystem.Int32To be addeda To be addedGLib.Property("max-width-chars")MethodSystem.Void
To be added.
To be added.
To be added.To be added.MethodSystem.Boolean
To be added.
To be added.
To be added.To be added.To be added.PropertyPango.WrapModeIndicates the wrap mode for the label.a .GLib.Property("wrap-mode")