Freigeben über


Pen-Konstruktor (Brush, Single)

Initialisiert eine neue Instanz der Pen-Klasse mit dem angegebenen Brush und der angegebenen Width.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Sub New ( _
    brush As Brush, _
    width As Single _
)
'Usage
Dim brush As Brush
Dim width As Single

Dim instance As New Pen(brush, width)
public Pen (
    Brush brush,
    float width
)
public:
Pen (
    Brush^ brush, 
    float width
)
public Pen (
    Brush brush, 
    float width
)
public function Pen (
    brush : Brush, 
    width : float
)

Parameter

  • brush
    Ein Brush, der die Merkmale dieses Pen bestimmt.
  • width
    Die Breite des neuen Pen.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

brush ist NULL (Nothing in Visual Basic).

Hinweise

Der Brush wird auf die vom brush-Parameter angegebene Farbe festgelegt, die Width-Eigenschaft wird auf den im width-Parameter angegebenen Wert festgelegt, und die Einheiten werden auf World festgelegt.

Beachten Sie, dass der brush-Parameter außerdem die Color-Eigenschaft dieses Pen angibt.

Das Zeichnen mit dem Pen bei einer width von 0 entspricht dem bei einer Breite von 1.

Beispiel

Im folgenden Codebeispiel wird ein Pen erstellt, und es werden die Auswirkungen des Festlegens der StartCap-Eigenschaft und der EndCap-Eigenschaft für einen Pen veranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms vorgesehen. Fügen Sie den Code in ein Formular ein, und rufen Sie beim Behandeln des Paint-Ereignisses des Formulars die ShowStartAndEndCaps-Methode auf, wobei Sie e als PaintEventArgs übergeben.

Private Sub Button3_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button3.Click

    Dim buttonGraphics As Graphics = Button3.CreateGraphics()
    Dim myPen As Pen = New Pen(Color.ForestGreen, 4.0F)
    myPen.DashStyle = Drawing2D.DashStyle.DashDotDot

    Dim theRectangle As Rectangle = Button3.ClientRectangle
    theRectangle.Inflate(-2, -2)
    buttonGraphics.DrawRectangle(myPen, theRectangle)
    buttonGraphics.Dispose()
    myPen.Dispose()
End Sub
private void Button3_Click(System.Object sender, System.EventArgs e)
{

    Graphics buttonGraphics = Button3.CreateGraphics();
    Pen myPen = new Pen(Color.ForestGreen, 4.0F);
    myPen.DashStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot;

    Rectangle theRectangle = Button3.ClientRectangle;
    theRectangle.Inflate(-2, -2);
    buttonGraphics.DrawRectangle(myPen, theRectangle);
    buttonGraphics.Dispose();
    myPen.Dispose();
}
private:
   void Button3_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Graphics^ buttonGraphics = Button3->CreateGraphics();
      Pen^ myPen = gcnew Pen( Color::ForestGreen,4.0F );
      myPen->DashStyle = System::Drawing::Drawing2D::DashStyle::DashDotDot;
      Rectangle theRectangle = Button3->ClientRectangle;
      theRectangle.Inflate(  -2, -2 );
      buttonGraphics->DrawRectangle( myPen, theRectangle );
      delete buttonGraphics;
      delete myPen;
   }
private void button3_Click(Object sender, System.EventArgs e)
{
    Graphics buttonGraphics = button3.CreateGraphics();
    Pen myPen = new Pen(Color.get_ForestGreen(), 4.0F);

    myPen.set_DashStyle(System.Drawing.Drawing2D.DashStyle.DashDotDot);

    Rectangle theRectangle = button3.get_ClientRectangle();

    theRectangle.Inflate(-2, -2);
    buttonGraphics.DrawRectangle(myPen, theRectangle);
    buttonGraphics.Dispose();
    myPen.Dispose();
} //button3_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Pen-Klasse
Pen-Member
System.Drawing-Namespace