This topic has not yet been rated Rate this topic

SizeF Structure

Stores an ordered pair of floating-point numbers, typically the width and height of a rectangle.

Namespace:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)
[SerializableAttribute]
[ComVisibleAttribute(true)]
[TypeConverterAttribute(typeof(SizeFConverter))]
public struct SizeF

The SizeF type exposes the following members.

  Name Description
Public method SizeF(PointF) Initializes a new instance of the SizeF structure from the specified PointF structure.
Public method SizeF(SizeF) Initializes a new instance of the SizeF structure from the specified existing SizeF structure.
Public method SizeF(Single, Single) Initializes a new instance of the SizeF structure from the specified dimensions.
Top
  Name Description
Public property Height Gets or sets the vertical component of this SizeF structure.
Public property IsEmpty Gets a value that indicates whether this SizeF structure has zero width and height.
Public property Width Gets or sets the horizontal component of this SizeF structure.
Top
  Name Description
Public method Static member Add Adds the width and height of one SizeF structure to the width and height of another SizeF structure.
Public method Equals Tests to see whether the specified object is a SizeF structure with the same dimensions as this SizeF structure. (Overrides ValueType.Equals(Object).)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Returns a hash code for this Size structure. (Overrides ValueType.GetHashCode.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method Static member Subtract Subtracts the width and height of one SizeF structure from the width and height of another SizeF structure.
Public method ToPointF Converts a SizeF structure to a PointF structure.
Public method ToSize Converts a SizeF structure to a Size structure.
Public method ToString Creates a human-readable string that represents this SizeF structure. (Overrides ValueType.ToString.)
Top
  Name Description
Public operator Static member Addition Adds the width and height of one SizeF structure to the width and height of another SizeF structure.
Public operator Static member Equality Tests whether two SizeF structures are equal.
Public operator Static member Narrowing(SizeF to PointF) Converts the specified SizeF structure to a PointF structure.
Public operator Static member Inequality Tests whether two SizeF structures are different.
Public operator Static member Subtraction Subtracts the width and height of one SizeF structure from the width and height of another SizeF structure.
Top
  Name Description
Public field Static member Empty Gets a SizeF structure that has a Height and Width value of 0.
Top

The unit for a SizeF structure depends on the PageUnit and PageScale settings for the Graphics object that is used to draw.

The following code example adds a shadow to a ListBox by using the following members:

This example is designed to be used with a Windows Form. To run this example, paste this code into a form and call the AddShadow method when handling the form's Paint event. Verify that the form contains a ListBox named listBox1.


private void AddShadow(PaintEventArgs e)
{

    // Create two SizeF objects.
    SizeF shadowSize = listBox1.Size;
    SizeF addSize = new SizeF(10.5F, 20.8F);

    // Add them together and save the result in shadowSize.
    shadowSize = shadowSize + addSize;

    // Get the location of the ListBox and convert it to a PointF.
    PointF shadowLocation = listBox1.Location;

    // Add two points to get a new location.
    shadowLocation = shadowLocation + new Size(5, 5);

    // Create a rectangleF. 
    RectangleF rectFToFill = 
        new RectangleF(shadowLocation, shadowSize);

    // Create a custom brush using a semi-transparent color, and 
    // then fill in the rectangle.
    Color customColor = Color.FromArgb(50, Color.Gray);
    SolidBrush shadowBrush = new SolidBrush(customColor);
    e.Graphics.FillRectangles(shadowBrush, new RectangleF[]{rectFToFill});

    // Dispose of the brush.
    shadowBrush.Dispose();
}


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(2000 characters remaining)
Community Content Add
Annotations FAQ