TextureBrush Klasse

Definition

Jede Eigenschaft der TextureBrush-Klasse ist ein Brush-Objekt, das das Innere einer Form mit einem Bild ausfüllt. 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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der FromFile -Methode eine neue Bitmap abrufen. Außerdem wird eine TextureBrushveranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Erstellen Sie ein Formular, das eine Schaltfläche mit dem Namen Button2 enthält. Fügen Sie den Code in das Formular ein, und ordnen Sie die Button2_Click-Methode dem Ereignis der Click Schaltfläche 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

Hinweis

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 verursacht Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

TextureBrush(Image)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild verwendet.

TextureBrush(Image, Rectangle)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild und das umschließende Rechteck verwendet.

TextureBrush(Image, Rectangle, ImageAttributes)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild, das angegebene umschließende Rechteck und die angegebenen Bildattribute verwendet.

TextureBrush(Image, RectangleF)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild und das umschließende Rechteck verwendet.

TextureBrush(Image, RectangleF, ImageAttributes)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild, das angegebene umschließende Rechteck und die angegebenen Bildattribute verwendet.

TextureBrush(Image, WrapMode)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild und den angegebenen Umbruchmodus verwendet.

TextureBrush(Image, WrapMode, Rectangle)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild, den angegebenen Umbruchmodus und das angegebene umschließende Rechteck verwendet.

TextureBrush(Image, WrapMode, RectangleF)

Initialisiert ein neues TextureBrush-Objekt, das das angegebene Bild, den angegebenen Umbruchmodus und das angegebene umschließende Rechteck verwendet.

Eigenschaften

Image

Ruft das Image-Objekt ab, das diesem TextureBrush-Objekt zugeordnet ist.

Transform

Ruft eine Kopie des Matrix-Objekt ab, das eine lokale geometrische Transformation für das diesem TextureBrush-Objekt zugeordnete Bild definiert, oder legt diese fest.

WrapMode

Ruft eine WrapMode-Enumeration ab, die den Umbruchmodus für dieses TextureBrush-Objekt angibt, oder legt diese fest.

Methoden

Clone()

Erstellt eine genaue Kopie dieses TextureBrush-Objekts.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von diesem Brush-Objekt verwendeten Ressourcen frei.

(Geerbt von Brush)
Dispose(Boolean)

Gibt die von Brush verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von Brush)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
MultiplyTransform(Matrix)

Multipliziert das Matrix-Objekt, das die lokale geometrische Transformation dieses TextureBrush-Objekts darstellt, mit dem angegebenen Matrix-Objekt, indem das angegebene Matrix-Objekt vorangestellt wird.

MultiplyTransform(Matrix, MatrixOrder)

Multipliziert das Matrix-Objekt, das die lokale geometrische Transformation dieses TextureBrush-Objekts darstellt, mit dem angegebenen Matrix-Objekt in der angegebenen Reihenfolge.

ResetTransform()

Setzt die Transform-Eigenschaft dieses TextureBrush-Objekts auf Identität.

RotateTransform(Single)

Dreht die lokale geometrische Transformation dieses TextureBrush-Objekts um den angegebenen Betrag. Diese Methode stellt der Transformation die Drehung voran.

RotateTransform(Single, MatrixOrder)

Dreht die lokale geometrische Transformation dieses TextureBrush-Objekts um den angegebenen Betrag in angegebener Reihenfolge.

ScaleTransform(Single, Single)

Skaliert die lokale geometrische Transformation dieses TextureBrush-Objekts um die angegebenen Beträge. Diese Methode stellt der Transformation die Skalierungsmatrix voran.

ScaleTransform(Single, Single, MatrixOrder)

Skaliert die lokale geometrische Transformation dieses TextureBrush-Objekts um die angegebenen Beträge in angegebener Reihenfolge.

SetNativeBrush(IntPtr)

Legt in einer abgeleiteten Klasse einen Verweis auf ein GDI+-Pinselobjekt fest.

(Geerbt von Brush)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TranslateTransform(Single, Single)

Verschiebt die lokale geometrische Transformation dieses TextureBrush-Objekts gemäß der angegebenen Dimensionen. Diese Methode stellt der Transformation die Verschiebung voran.

TranslateTransform(Single, Single, MatrixOrder)

Verschiebt die lokale geometrische Transformation dieses TextureBrush-Objekts in der angegebenen Reihenfolge um die angegebenen Abmessungen.

Gilt für: