TextureBrush Classe

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cada propriedade da classe TextureBrush é um objeto Brush 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: Object

MarshalByRefObject

Brush
TextureBrush

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 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

Observação

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

Construtores

TextureBrush(Image)	Inicializa um novo objeto TextureBrush que usa a imagem especificada.
TextureBrush(Image, Rectangle)	Inicializa um novo objeto TextureBrush que usa a imagem especificada e o retângulo delimitador.
TextureBrush(Image, Rectangle, ImageAttributes)	Inicializa um novo objeto TextureBrush que usa a imagem especificada, o retângulo delimitador e atributos de imagem.
TextureBrush(Image, RectangleF)	Inicializa um novo objeto TextureBrush que usa a imagem especificada e o retângulo delimitador.
TextureBrush(Image, RectangleF, ImageAttributes)	Inicializa um novo objeto TextureBrush que usa a imagem especificada, o retângulo delimitador e atributos de imagem.
TextureBrush(Image, WrapMode)	Inicializa um novo objeto TextureBrush que usa a imagem especificada e o modo de encapsulamento.
TextureBrush(Image, WrapMode, Rectangle)	Inicializa um novo objeto TextureBrush que usa a imagem especificada, o modo de encapsulamento e o retângulo delimitador.
TextureBrush(Image, WrapMode, RectangleF)	Inicializa um novo objeto TextureBrush que usa a imagem especificada, o modo de encapsulamento e o retângulo delimitador.

Propriedades

Image	Obtém o objeto Image associado a esse objeto TextureBrush.
Transform	Obtém ou define uma cópia do objeto Matrix que define uma transformação geométrica local para a imagem associada a esse objeto TextureBrush.
WrapMode	Obtém ou define uma enumeração WrapMode que indica o modo de encapsulamento para esse objeto TextureBrush.

Métodos

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 esse 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 de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MultiplyTransform(Matrix)	Multiplica o objeto Matrix que representa a transformação geométrica local desse objeto TextureBrush pelo objeto Matrix especificado precedendo o objeto Matrix especificado.
MultiplyTransform(Matrix, MatrixOrder)	Multiplica o objeto Matrix que representa a transformação geométrica local desse objeto TextureBrush pelo objeto Matrix especificado na ordem especificada.
ResetTransform()	Redefine a propriedade `Transform` desse objeto TextureBrush como identidade.
RotateTransform(Single)	Gira a transformação geométrica local desse objeto TextureBrush no valor especificado. Esse método precede a rotação para a transformação.
RotateTransform(Single, MatrixOrder)	Gira a transformação geométrica local desse objeto TextureBrush no valor especificado na ordem especificada.
ScaleTransform(Single, Single)	Dimensiona a transformação geométrica local desse objeto TextureBrush nos valores especificados. Esse método precede a matriz de escala para a transformação.
ScaleTransform(Single, Single, MatrixOrder)	Dimensiona a transformação geométrica local desse objeto TextureBrush nos valores especificados na ordem especificada.
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)	Move a transformação geométrica local desse objeto TextureBrush nas dimensões especificadas. Esse método precede a translação para a transformação.
TranslateTransform(Single, Single, MatrixOrder)	Move a transformação geométrica local desse objeto TextureBrush nas dimensões especificadas e na ordem especificada.

Aplica-se a