TextureBrush Classe

Definição

Cada propriedade da TextureBrush classe é um Brush objeto que usa uma imagem para preencher o interior de uma forma. Essa classe não pode ser herdada.

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
Herança

Exemplos

O exemplo de código a seguir demonstra como obter um novo bitmap usando o FromFile método. Ele também demonstra um TextureBrush.

Este exemplo foi projetado para ser usado com o Windows Forms. Crie um formulário que contenha um botão chamado Button2. Cole o código no formulário e associe o método Button2_Click ao evento do Click botão.

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

Comentários

Note

No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.

Construtores

Nome Description
TextureBrush(Image, Rectangle, ImageAttributes)

Inicializa um novo TextureBrush objeto que usa a imagem especificada, o retângulo delimitador e os atributos de imagem.

TextureBrush(Image, Rectangle)

Inicializa um novo TextureBrush objeto que usa a imagem especificada e o retângulo delimitador.

TextureBrush(Image, RectangleF, ImageAttributes)

Inicializa um novo TextureBrush objeto que usa a imagem especificada, o retângulo delimitador e os atributos de imagem.

TextureBrush(Image, RectangleF)

Inicializa um novo TextureBrush objeto que usa a imagem especificada e o retângulo delimitador.

TextureBrush(Image, WrapMode, Rectangle)

Inicializa um novo TextureBrush objeto que usa a imagem especificada, o modo de encapsulamento e o retângulo delimitador.

TextureBrush(Image, WrapMode, RectangleF)

Inicializa um novo TextureBrush objeto que usa a imagem especificada, o modo de encapsulamento e o retângulo delimitador.

TextureBrush(Image, WrapMode)

Inicializa um novo TextureBrush objeto que usa a imagem especificada e o modo de encapsulamento.

TextureBrush(Image)

Inicializa um novo TextureBrush objeto que usa a imagem especificada.

Propriedades

Nome Description
Image

Obtém o Image objeto associado a esse TextureBrush objeto.

Transform

Obtém ou define uma cópia do Matrix objeto que define uma transformação geométrica local para a imagem associada a esse TextureBrush objeto.

WrapMode

Obtém ou define uma WrapMode enumeração que indica o modo de encapsulamento para esse TextureBrush objeto.

Métodos

Nome Description
Clone()

Cria uma cópia exata desse objeto TextureBrush.

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados por este objeto Brush.

(Herdado de Brush)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Brush e, opcionalmente, libera os recursos gerenciados.

(Herdado de Brush)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
MultiplyTransform(Matrix, MatrixOrder)

Multiplica o Matrix objeto que representa a transformação geométrica local desse TextureBrush objeto pelo objeto especificado Matrix na ordem especificada.

MultiplyTransform(Matrix)

Multiplica o Matrix objeto que representa a transformação geométrica local desse TextureBrush objeto pelo objeto especificado Matrix , acrescentando o objeto especificado Matrix .

ResetTransform()

Redefine a Transform propriedade desse TextureBrush objeto para identidade.

RotateTransform(Single, MatrixOrder)

Gira a transformação geométrica local desse TextureBrush objeto pela quantidade especificada na ordem especificada.

RotateTransform(Single)

Gira a transformação geométrica local desse TextureBrush objeto pela quantidade especificada. Esse método prepara a rotação para a transformação.

ScaleTransform(Single, Single, MatrixOrder)

Dimensiona a transformação geométrica local desse TextureBrush objeto pelos valores especificados na ordem especificada.

ScaleTransform(Single, Single)

Dimensiona a transformação geométrica local desse TextureBrush objeto pelas quantidades especificadas. Esse método prepara a matriz de dimensionamento para a transformação.

SetNativeBrush(IntPtr)

Em uma classe derivada, define uma referência a um objeto de pincel GDI+.

(Herdado de Brush)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TranslateTransform(Single, Single, MatrixOrder)

Converte a transformação geométrica local desse TextureBrush objeto pelas dimensões especificadas na ordem especificada.

TranslateTransform(Single, Single)

Converte a transformação geométrica local desse TextureBrush objeto pelas dimensões especificadas. Esse método prepara a tradução para a transformação.

Aplica-se a