Graphics.DrawIconUnstretched(Icon, Rectangle) 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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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.

Desenha a imagem representada pelo Icon especificado sem dimensionar a imagem.

public:
 void DrawIconUnstretched(System::Drawing::Icon ^ icon, System::Drawing::Rectangle targetRect);

public void DrawIconUnstretched (System.Drawing.Icon icon, System.Drawing.Rectangle targetRect);

member this.DrawIconUnstretched : System.Drawing.Icon * System.Drawing.Rectangle -> unit

Public Sub DrawIconUnstretched (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. A imagem não é dimensionada para se ajustar a esse retângulo, mas mantém seu tamanho original. Se a imagem for maior que o retângulo, ela será recortada para caber dentro dela.

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 ícone desenhado é não dimensionado e descompactado.

private:
   void DrawIconUnstretchedRectangle( 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->DrawIconUnstretched( newIcon, rect );
   }

private void DrawIconUnstretchedRectangle(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.DrawIconUnstretched(newIcon, rect);
}

Private Sub DrawIconUnstretchedRectangle(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.DrawIconUnstretched(newIcon, rect)
End Sub

Aplica-se a

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Partilhar via