Label | marshal by reference, disposable |
System.Windows.Forms (system.windows.forms.dll) | class |
This Control provides a simple, non-editable text
label.
The control has the ability to AutoSize to the
content, although care should be taken to ensure that the layout
engine can cope with this neatly. If you set the
UseMnemonic property to true,
you can use Alt key shortcuts. The control strips out the first
&, underlines the subsequent character, and ensures that the
focus is set to the next element in the tab order when the Alt key
combination is pressed. The label itself cannot receive the focus.
In addition to the Text, you can add an
Image or an item from an
ImageList (the one at a particular
ImageIndex).
Alternatively, you can set the FlatStyle to
System, and fall back on the standard OS
rendering, perhaps for XP theme support. You lose the image support,
however.
public class Label : Control {
// Public Constructors
public Label();
// Public Instance Properties
public virtual bool AutoSize{set; get; }
public override Image BackgroundImage{set; get; }
// overrides Control
public virtual BorderStyle BorderStyle{set; get; }
public FlatStyle FlatStyle{set; get; }
public Image Image{set; get; }
public ContentAlignment ImageAlign{set; get; }
public int ImageIndex{set; get; }
public ImageList ImageList{set; get; }
public ImeMode ImeMode{set; get; }
// overrides Control
public virtual int PreferredHeight{get; }
public virtual int PreferredWidth{get; }
public bool TabStop{set; get; }
// overrides Control
public virtual ContentAlignment TextAlign{set; get; }
public bool UseMnemonic{set; get; }
// Protected Instance Properties
protected override CreateParams CreateParams{get; }
// overrides Control
protected override ImeMode DefaultImeMode{get; }
// overrides Control
protected override Size DefaultSize{get; }
// overrides Control
protected virtual bool RenderTransparent{set; get; }
// overrides Control
// Public Instance Methods
public override string ToString(); // overrides System.ComponentModel.Component
// Protected Instance Methods
protected Rectangle CalcImageRenderBounds(System.Drawing.Image image, System.Drawing.Rectangle r,
System.Drawing.ContentAlignment align);
protected override AccessibleObject CreateAccessibilityInstance(); // overrides Control
protected override void Dispose(bool disposing); // overrides Control
protected void DrawImage(System.Drawing.Graphics g, System.Drawing.Image image,
System.Drawing.Rectangle r, System.Drawing.ContentAlignment align);
protected virtual void OnAutoSizeChanged(EventArgs e);
protected override void OnEnabledChanged(EventArgs e); // overrides Control
protected override void OnFontChanged(EventArgs e); // overrides Control
protected override void OnPaint(PaintEventArgs e); // overrides Control
protected override void OnParentChanged(EventArgs e); // overrides Control
protected virtual void OnTextAlignChanged(EventArgs e);
protected override void OnTextChanged(EventArgs e); // overrides Control
protected override void OnVisibleChanged(EventArgs e); // overrides Control
protected override bool ProcessMnemonic(char charCode); // overrides Control
protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified); // overrides Control
protected override void WndProc(ref Message m); // overrides Control
// Events
public event EventHandler AutoSizeChanged;
public event KeyEventHandler KeyDown;
// overrides Control
public event KeyPressEventHandler KeyPress;
// overrides Control
public event KeyEventHandler KeyUp;
// overrides Control
public event EventHandler TextAlignChanged;
}
Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component(System.ComponentModel.IComponen,
System.IDisposable)
Control(IOleContro, IOleObject,
IOleInPlaceObject,
IOleInPlaceActiveObject,
IOleWindow, IViewObject,
IViewObject2, IPersist,
IPersistStreamInit,
IPersistPropertyBag,
IPersistStorage,
IQuickActivate,
System.ComponentModel.ISynchronizeInvoke,
IWin32Window) Label
Subclasses
LinkLabel
|