Graphics.DrawIconUnstretched(Icon, Rectangle) Méthode

Définition

Dessine l’image représentée par le Icon spécifié sans mettre à l’échelle 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

Rectangle structure qui spécifie l’emplacement et la taille de l’image résultante. L’image n’est pas mise à l’échelle pour s’adapter à ce rectangle, mais conserve sa taille d’origine. Si l’image est plus grande que le rectangle, elle est clippée pour s’y ajuster.

Exceptions

icon est 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 gestionnaire d’événements Paint. Le code effectue les actions suivantes :

  • Crée une icône à partir d’un fichier d’icône 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 sur l’écran, et l’icône dessinée n’est pas mise à l’échelle et non 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

S’applique à