TextureBrush Klasse

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v11.0.0-preview.4.26230.115

Quelle:

TextureBrush.cs

Jede Eigenschaft der TextureBrush Klasse ist ein Brush Objekt, das ein Bild verwendet, um das Innere einer Form zu füllen. Diese Klasse kann nicht vererbt werden.

public ref class TextureBrush sealed : System::Drawing::Brush

public sealed class TextureBrush : System.Drawing.Brush

type TextureBrush = class
    inherit Brush

Public NotInheritable Class TextureBrush
Inherits Brush

Vererbung

Object

MarshalByRefObject

Brush

TextureBrush

Beispiele

Im folgenden Codebeispiel wird das Abrufen einer neuen Bitmap mithilfe der FromFile Methode veranschaulicht. Außerdem wird ein TextureBrush.

Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Erstellen Sie ein Formular mit einer Schaltfläche mit dem Namen Button2. Fügen Sie den Code in das Formular ein, und ordnen Sie die Button2_Click Methode dem Ereignis der Schaltfläche Click zu.

private:
   void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         Bitmap^ image1 = dynamic_cast<Bitmap^>(Image::FromFile( "C:\\Documents and Settings\\"
         "All Users\\Documents\\My Music\\music.bmp", true ));
         TextureBrush^ texture = gcnew TextureBrush( image1 );
         texture->WrapMode = System::Drawing::Drawing2D::WrapMode::Tile;
         Graphics^ formGraphics = this->CreateGraphics();
         formGraphics->FillEllipse( texture, RectangleF(90.0F,110.0F,100,100) );
         delete formGraphics;
      }
      catch ( System::IO::FileNotFoundException^ ) 
      {
         MessageBox::Show( "There was an error opening the bitmap."
         "Please check the path." );
      }
   }

private void Button2_Click(System.Object sender, System.EventArgs e)
{
    try
    {
        Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
            @"All Users\Documents\My Music\music.bmp", true);

        TextureBrush texture = new TextureBrush(image1);
        texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
        Graphics formGraphics = this.CreateGraphics();
        formGraphics.FillEllipse(texture, 
            new RectangleF(90.0F, 110.0F, 100, 100));
        formGraphics.Dispose();
    }
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("There was an error opening the bitmap." +
            "Please check the path.");
    }
}

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click
    Try
        Dim image1 As Bitmap = _
            CType(Image.FromFile("C:\Documents and Settings\" _
            & "All Users\Documents\My Music\music.bmp", True), Bitmap)

        Dim texture As New TextureBrush(image1)
        texture.WrapMode = Drawing2D.WrapMode.Tile
        Dim formGraphics As Graphics = Me.CreateGraphics()
        formGraphics.FillEllipse(texture, _
            New RectangleF(90.0F, 110.0F, 100, 100))
        formGraphics.Dispose()

    Catch ex As System.IO.FileNotFoundException
        MessageBox.Show("There was an error opening the bitmap." _
            & "Please check the path.")
    End Try

End Sub

Hinweise

Note

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps führt zu Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

Name	Beschreibung
TextureBrush(Image, Rectangle, ImageAttributes)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild, das umgebende Rechteck und Bildattribute verwendet.
TextureBrush(Image, Rectangle)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild und das umgebende Rechteck verwendet.
TextureBrush(Image, RectangleF, ImageAttributes)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild, das umgebende Rechteck und Bildattribute verwendet.
TextureBrush(Image, RectangleF)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild und das umgebende Rechteck verwendet.
TextureBrush(Image, WrapMode, Rectangle)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild, den Umbruchmodus und das umgebende Rechteck verwendet.
TextureBrush(Image, WrapMode, RectangleF)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild, den Umbruchmodus und das umgebende Rechteck verwendet.
TextureBrush(Image, WrapMode)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild und den Umbruchmodus verwendet.
TextureBrush(Image)	Initialisiert ein neues TextureBrush Objekt, das das angegebene Bild verwendet.

Eigenschaften

Name	Beschreibung
Image	Ruft das Image diesem TextureBrush Objekt zugeordnete Objekt ab.
Transform	Dient zum Abrufen oder Festlegen einer Kopie des Matrix Objekts, das eine lokale geometrische Transformation für das Bild definiert, das diesem TextureBrush Objekt zugeordnet ist.
WrapMode	Dient zum Abrufen oder Festlegen einer WrapMode Aufzählung, die den Umbruchmodus für dieses TextureBrush Objekt angibt.

Methoden

Name	Beschreibung
Clone()	Erstellt eine genaue Kopie dieses TextureBrush Objekts.
Dispose()	Gibt alle von diesem Brush Objekt verwendeten Ressourcen frei. (Geerbt von Brush)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den Brush verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Brush)
MultiplyTransform(Matrix, MatrixOrder)	Multipliziert das Matrix Objekt, das die lokale geometrische Transformation dieses TextureBrush Objekts durch das angegebene Matrix Objekt in der angegebenen Reihenfolge darstellt.
MultiplyTransform(Matrix)	Multipliziert das Matrix Objekt, das die lokale geometrische Transformation dieses TextureBrush Objekts durch das angegebene Matrix Objekt darstellt, indem das angegebene Matrix Objekt vorausgestellt wird.
ResetTransform()	Setzt die Transform Eigenschaft dieses TextureBrush Objekts auf Identität zurück.
RotateTransform(Single, MatrixOrder)	Dreht die lokale geometrische Transformation dieses TextureBrush Objekts um den angegebenen Betrag in der angegebenen Reihenfolge.
RotateTransform(Single)	Dreht die lokale geometrische Transformation dieses TextureBrush Objekts um den angegebenen Betrag. Diese Methode stellt die Drehung der Transformation voran.
ScaleTransform(Single, Single, MatrixOrder)	Skaliert die lokale geometrische Transformation dieses TextureBrush Objekts um die angegebenen Mengen in der angegebenen Reihenfolge.
ScaleTransform(Single, Single)	Skaliert die lokale geometrische Transformation dieses TextureBrush Objekts um die angegebenen Beträge. Diese Methode stellt die Skalierungsmatrix der Transformation voran.
SetNativeBrush(IntPtr)	Legt in einer abgeleiteten Klasse einen Verweis auf ein GDI+-Pinselobjekt fest. (Geerbt von Brush)
TranslateTransform(Single, Single, MatrixOrder)	Übersetzt die lokale geometrische Transformation dieses TextureBrush Objekts durch die angegebenen Dimensionen in der angegebenen Reihenfolge.
TranslateTransform(Single, Single)	Übersetzt die lokale geometrische Transformation dieses TextureBrush Objekts durch die angegebenen Dimensionen. Diese Methode stellt die Übersetzung der Transformation voran.