Graphics.DrawIconUnstretched(Icon, Rectangle) Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Graphics.cs

Dessine l'image représentée par le Icon spécifié sans mise à l'échelle de l'image.

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)

Paramètres

icon

Icon

Icon à dessiner.

targetRect

Rectangle

Structure Rectangle qui spécifie l'emplacement et la taille de l'image résultante. L'image n'est pas ajustée de manière à tenir à l'intérieur de ce rectangle, mais conserve sa taille d'origine. Si l'image dépasse le rectangle, elle est alors découpée de manière à pouvoir tenir à l'intérieur.

Exceptions

ArgumentNullException

icon a la valeur null.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. Le code effectue les actions suivantes :

• Crée une icône à partir d’un fichier d’icônes Windows standard SampIcon.ico dans l’exemple de dossier.

• Crée un rectangle dans lequel dessiner l’icône.

• Dessine l’icône à l’écran.

La position du rectangle localise l’icône à l’écran, et l’icône dessinée n’est pas mise à l’échelle et n’est pas mise à l’échelle.

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