Graphics.DrawIcon Método

  • Referência

Definição

Namespace:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Pacote:
System.Drawing.Common v8.0.7
Pacote:
System.Drawing.Common v9.0.0-preview.6.24327.6

Desenha a imagem representada pelo Icon especificado nas coordenadas especificadas.

Sobrecargas

DrawIcon(Icon, Rectangle)

Desenha a imagem representada pelo Icon especificado dentro da área especificada por uma estrutura de Rectangle.
DrawIcon(Icon, Int32, Int32)

Desenha a imagem representada pelo Icon especificado nas coordenadas especificadas.

DrawIcon(Icon, Rectangle)

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a imagem representada pelo Icon especificado dentro da área especificada por uma estrutura de Rectangle.

public:
 void DrawIcon(System::Drawing::Icon ^ icon, System::Drawing::Rectangle targetRect);
public void DrawIcon (System.Drawing.Icon icon, System.Drawing.Rectangle targetRect);
member this.DrawIcon : System.Drawing.Icon * System.Drawing.Rectangle -> unit
Public Sub DrawIcon (icon As Icon, targetRect As Rectangle)

Parâmetros

icon
Icon

Icon desenhar.

targetRect
Rectangle

Rectangle estrutura que especifica o local e o tamanho da imagem resultante na superfície de exibição. A imagem contida no parâmetro icon é dimensionada para as dimensões dessa área retangular.

Exceções

ArgumentNullException

icon é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

  • Cria um ícone de um arquivo de ícone padrão do Windows SampIcon.ico na pasta de exemplo.

  • Cria um retângulo no qual desenhar o ícone.

  • Desenha o ícone para a tela.

A posição do retângulo localiza o ícone na tela e o tamanho do retângulo determina o dimensionamento do ícone desenhado.

private:
   void DrawIconRectangle( PaintEventArgs^ e )
   {
      // Create icon.
      System::Drawing::Icon^ newIcon = gcnew System::Drawing::Icon( "SampIcon.ico" );

      // Create rectangle for icon.
      Rectangle rect = Rectangle(100,100,200,200);

      // Draw icon to screen.
      e->Graphics->DrawIcon( newIcon, rect );
   }

private void DrawIconRectangle(PaintEventArgs e)
{        
    // Create icon.
    Icon newIcon = new Icon("SampIcon.ico");
             
    // Create rectangle for icon.
    Rectangle rect = new Rectangle(100, 100, 200, 200);
             
    // Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, rect);
}

Private Sub DrawIconRectangle(ByVal e As PaintEventArgs)

    ' Create icon.
    Dim newIcon As New Icon("SampIcon.ico")

    ' Create rectangle for icon.
    Dim rect As New Rectangle(100, 100, 200, 200)

    ' Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, rect)
End Sub

Aplica-se a

DrawIcon(Icon, Int32, Int32)

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a imagem representada pelo Icon especificado nas coordenadas especificadas.

public:
 void DrawIcon(System::Drawing::Icon ^ icon, int x, int y);
public void DrawIcon (System.Drawing.Icon icon, int x, int y);
member this.DrawIcon : System.Drawing.Icon * int * int -> unit
Public Sub DrawIcon (icon As Icon, x As Integer, y As Integer)

Parâmetros

icon
Icon

Icon desenhar.

x
Int32

A coordenada x do canto superior esquerdo da imagem desenhada.

y
Int32

A coordenada y do canto superior esquerdo da imagem desenhada.

Exceções

ArgumentNullException

icon é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

  • Cria um ícone de um arquivo de ícone padrão do Windows SampIcon.ico na pasta de exemplo.

  • Cria as coordenadas do canto superior esquerdo no qual desenhar o ícone.

  • Desenha o ícone para a tela.

O ícone desenhado não está dimensionado.

private:
   void DrawIconInt( PaintEventArgs^ e )
   {

      // Create icon.
      System::Drawing::Icon^ newIcon = gcnew System::Drawing::Icon( "SampIcon.ico" );

      // Create coordinates for upper-left corner of icon.
      int x = 100;
      int y = 100;

      // Draw icon to screen.
      e->Graphics->DrawIcon( newIcon, x, y );
   }

private void DrawIconInt(PaintEventArgs e)
{
    // Create icon.
    Icon newIcon = new Icon("SampIcon.ico");
             
    // Create coordinates for upper-left corner of icon.
    int x = 100;
    int y = 100;
             
    // Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, x, y);
}

Private Sub DrawIconInt(ByVal e As PaintEventArgs)

    ' Create icon.
    Dim newIcon As New Icon("SampIcon.ico")

    ' Create coordinates for upper-left corner of icon.
    Dim x As Integer = 100
    Dim y As Integer = 100

    ' Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, x, y)
End Sub

Aplica-se a