ImageList.ImageCollection.AddStrip(Image) 메서드

정의

지정된 이미지에 대한 이미지 스트립을 ImageList에 추가합니다.Adds an image strip for the specified image to the ImageList.

public:
 int AddStrip(System::Drawing::Image ^ value);
public int AddStrip (System.Drawing.Image value);
member this.AddStrip : System.Drawing.Image -> int
Public Function AddStrip (value As Image) As Integer

매개 변수

value
Image

추가할 이미지가 있는 Bitmap입니다.A Bitmap with the images to add.

반환

인덱스는 새로 추가 된 이미지 또는 이미지를 추가할 수 없는 경우-1입니다.The index of the newly added image, or -1 if the image cannot be added.

예외

추가되는 이미지가 null인 경우The image being added is null.

-또는--or- 추가되는 이미지가 Bitmap이 아닌 경우The image being added is not a Bitmap.

이미지를 추가할 수 없습니다.The image cannot be added.

-또는--or-

추가할 이미지 스트립의 너비가 0 또는 너비를 기존 이미지 너비와 같지 않습니다.The width of image strip being added is 0, or the width is not equal to the existing image width.

-또는--or-

이미지 스트립 높이가 기존 이미지 높이 같지 않습니다.The image strip height is not equal to existing image height.

예제

다음 예에서는 AddStrip를 사용 하는 방법을 보여 줍니다.The following example demonstrates how to use AddStrip. 이 예제를 실행 하려면 imageList1 라는 ImageList 포함 된 Windows Form에 다음 코드를 붙여넣고 단추 Click 이벤트를 처리할 때이 예제의 AddStripToCollection 메서드를 호출 합니다.To run this example, paste the following code into a Windows Form that contains an ImageList named imageList1 and a button and call the AddStripToCollection method in this example when handling the button's Click event.

public void AddStripToCollection()
{
    // Add the image strip.
    Bitmap bitmaps = new Bitmap(typeof(PrintPreviewDialog), "PrintPreviewStrip.bmp");
    imageList1.Images.AddStrip(bitmaps);
    
    // Iterate through the images and display them on the form.
    for (int i = 0; i < imageList1.Images.Count; i++) {
    
        imageList1.Draw(this.CreateGraphics(), new Point(10,10), i);
        Application.DoEvents();
        System.Threading.Thread.Sleep(1000);
        
    }

}
Private Sub AddStripToCollection() 
    ' Add the image strip.
    Dim bitmaps As New Bitmap(GetType(PrintPreviewDialog), "PrintPreviewStrip.bmp")
    imageList1.Images.AddStrip(bitmaps)
    
    ' Iterate through the images and display them on the form.
    For i As Integer = 0 To imageList1.Images.Count - 1
        
        imageList1.Draw(Me.CreateGraphics(), New Point(10, 10), i)
        Application.DoEvents()
        System.Threading.Thread.Sleep(1000)
    Next
 
End Sub



설명

추가할 이미지 수가 지정된 된 이미지의 너비에서 유추 됩니다.The number of images to add is inferred from the width of the given image.

스트립에는 여러 이미지-나란히 정렬 하는 대로 처리 되는 단일 이미지입니다.A strip is a single image that is treated as multiple images arranged side-by-side.

적용 대상