이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

PictureBox 클래스

.NET Framework 3.5

다른 버전

업데이트: 2007년 11월

이미지를 표시할 Windows PictureBox 컨트롤을 나타냅니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(System.Windows.Forms.dll)

구문

C++

[DockingAttribute(DockingBehavior.Ask)]
[ComVisibleAttribute(true)]
[DefaultBindingPropertyAttribute("Image")]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class PictureBox : Control, ISupportInitialize

/** @attribute DockingAttribute(DockingBehavior.Ask) */
/** @attribute ComVisibleAttribute(true) */
/** @attribute DefaultBindingPropertyAttribute("Image") */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class PictureBox extends Control implements ISupportInitialize

JScript

public class PictureBox extends Control implements ISupportInitialize

설명

일반적으로 PictureBox는 비트맵, 메타 파일, 아이콘, JPEG, GIF 또는 PNG 파일의 그래픽을 표시하는 데 사용됩니다.

Image 속성을 디자인 타임 또는 런타임에 표시할 Image로 설정합니다. 또는 ImageLocation 속성을 설정하여 이미지를 지정한 다음 Load 메서드를 사용하여 동기식으로 이미지를 로드하거나 LoadAsync 메서드를 사용하여 비동기식으로 이미지를 로드할 수 있습니다.

참고:
여러 PictureBox 컨트롤에 같은 이미지를 사용하려면 각 PictureBox에 대한 이미지 복제본을 만듭니다. 여러 컨트롤의 같은 이미지에 액세스하면 예외가 발생합니다.

PictureBoxSizeMode 열거형의 값으로 설정되는 SizeMode 속성은 표시 영역에 이미지를 클리핑하고 배치하는 작업을 제어합니다. ClientSize 속성을 사용하여 런타임에 표시 영역의 크기를 변경할 수 있습니다.

기본적으로 PictureBox 컨트롤은 테두리 없이 표시됩니다. BorderStyle 속성을 사용하여 표준 또는 3차원 테두리를 제공하면 그림 상자를 폼의 나머지 부분과 구별할 수 있습니다. 이미지가 포함되어 있지 않은 경우에도 해당됩니다. PictureBox는 선택할 수 없는 컨트롤, 즉 입력 포커스를 받을 수 없는 컨트롤입니다.

예제

다음 코드 예제에서는 이미지를 설정하고 그림 상자의 표시 영역을 조정할 수 있는 방법을 보여 줍니다. 이 예제를 실행하려면 ShowMyImage가 기존 폼에서 호출되고 System.Drawing 네임스페이스가 폼의 소스 코드에 추가되어 있어야 합니다.

C++

private Bitmap MyImage ;
public void ShowMyImage(String fileToDisplay, int xSize, int ySize)
{
   // Sets up an image object to be displayed.
   if (MyImage != null)
   {
      MyImage.Dispose();
   }

   // Stretches the image to fit the pictureBox.
   pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage ;
   MyImage = new Bitmap(fileToDisplay);
   pictureBox1.ClientSize = new Size(xSize, ySize);
   pictureBox1.Image = (Image) MyImage ;
}

private Bitmap myImage;
public void ShowMyImage(String fileToDisplay, int xSize, int ySize)
{
    // Sets up an image object to be displayed.
    if (myImage != null) {
        myImage.Dispose();
    }

    // Stretches the image to fit the pictureBox.
    pictureBox1.set_SizeMode(PictureBoxSizeMode.StretchImage);
    myImage = new Bitmap(fileToDisplay);
    pictureBox1.set_ClientSize(new Size(xSize, ySize));
    pictureBox1.set_Image(myImage);
} //ShowMyImage

상속 계층 구조

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.PictureBox

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

버전 정보