PictureBox 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表 Windows 圖片框的控制項，用於顯示影像。
public ref class PictureBox : System::Windows::Forms::Controlpublic ref class PictureBox : System::Windows::Forms::Control, System::ComponentModel::ISupportInitializepublic class PictureBox : System.Windows.Forms.Control[System.ComponentModel.DefaultBindingProperty("Image")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class PictureBox : System.Windows.Forms.Control, System.ComponentModel.ISupportInitialize[System.ComponentModel.DefaultBindingProperty("Image")]
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class PictureBox : System.Windows.Forms.Control, System.ComponentModel.ISupportInitializetype PictureBox = class
inherit Control[<System.ComponentModel.DefaultBindingProperty("Image")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type PictureBox = class
inherit Control
interface ISupportInitialize[<System.ComponentModel.DefaultBindingProperty("Image")>]
[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type PictureBox = class
inherit Control
interface ISupportInitializePublic Class PictureBox
Inherits ControlPublic Class PictureBox
Inherits Control
Implements ISupportInitialize- 繼承
- 屬性
- 實作
範例
以下程式碼範例說明如何設定圖片並調整圖片框的顯示區域大小。 這個例子需要 在 ShowMyImage 現有表單中被呼叫，且 System.Drawing 該命名空間已被加入你的表單的原始碼中。
Bitmap^ MyImage;
public:
void ShowMyImage( String^ fileToDisplay, int xSize, int ySize )
{
// Sets up an image object to be displayed.
if ( MyImage != nullptr )
{
delete MyImage;
}
// Stretches the image to fit the pictureBox.
pictureBox1->SizeMode = PictureBoxSizeMode::StretchImage;
MyImage = gcnew Bitmap( fileToDisplay );
pictureBox1->ClientSize = System::Drawing::Size( xSize, ySize );
pictureBox1->Image = dynamic_cast<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.SizeMode = PictureBoxSizeMode.StretchImage ;
MyImage = new Bitmap(fileToDisplay);
pictureBox1.ClientSize = new Size(xSize, ySize);
pictureBox1.Image = (Image) MyImage ;
}
Private MyImage As Bitmap
Public Sub ShowMyImage(fileToDisplay As String, xSize As Integer, _
ySize As Integer)
' Sets up an image object to be displayed.
If (MyImage IsNot Nothing) Then
MyImage.Dispose()
End If
' Stretches the image to fit the pictureBox.
pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
MyImage = New Bitmap(fileToDisplay)
pictureBox1.ClientSize = New Size(xSize, ySize)
pictureBox1.Image = CType(MyImage, Image)
End Sub
備註
通常用於 PictureBox 顯示點陣圖、元檔案、圖示、JPEG、GIF 或 PNG 檔案中的圖形。
在設計時或執行時，將屬性設定Image為你想顯示的 。Image 你也可以透過設定 ImageLocation 屬性來指定圖片，並用該 Load 方法同步載入圖片，或用該 LoadAsync 方法非同步載入。
備註
如果你想在多個 PictureBox 控制項中使用同一張映像，請為每個 PictureBox建立該影像的複製品。 從多個控制項存取同一影像會產生例外。
該 SizeMode 屬性設定為列舉中的值 PictureBoxSizeMode ，控制影像在顯示區域中的裁剪與位置。 你可以在執行時用 ClientSize 屬性調整顯示區域的大小。
預設情況下， PictureBox 控制權顯示為無邊框。 你可以利用這個 BorderStyle 特性提供標準或三維邊框，將圖片框與其他部分區分開來，即使它沒有包含圖片。 這個 PictureBox 控制器不可選擇，也就是無法接收輸入對焦。
建構函式
| 名稱 | Description |
|---|---|
| PictureBox() |
初始化 PictureBox 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| AccessibilityObject |
讓被 AccessibleObject 指派到控制室。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定控制項的預設動作描述，供無障礙客戶端應用程式使用。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定無障礙客戶端應用程式所使用的控制項描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定無障礙客戶端應用程式所使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制的可及角色。 (繼承來源 Control) |
| AllowDrop |
覆蓋該財產權 AllowDrop 。 |
| Anchor |
取得或設定控制項綁定容器的邊緣，並決定控制項如何與父控制項進行調整大小。 (繼承來源 Control) |
| AutoScrollOffset |
取得或設定，將此控制捲動至。ScrollControlIntoView(Control) (繼承來源 Control) |
| AutoSize |
此性質對此類別無關。 (繼承來源 Control) |
| BackColor |
取得或設定控制點的背景色。 (繼承來源 Control) |
| BackgroundImage |
取得或設定控制中顯示的背景影像。 (繼承來源 Control) |
| BackgroundImageLayout |
取得或設定背景影像佈局，依照 ImageLayout 列舉定義。 (繼承來源 Control) |
| BindingContext |
取得或設定 BindingContext 控制。 (繼承來源 Control) |
| BorderStyle |
表示控制區的邊框風格。 |
| Bottom |
取得控制項底部邊緣與容器用戶端區域頂部邊緣之間的距離（像素）。 (繼承來源 Control) |
| Bounds |
取得或設定控制項的大小與位置，包括非用戶端元素，以像素為單位，相對於父控制項。 (繼承來源 Control) |
| CanEnableIme |
會取得一個值，表示該屬性是否 ImeMode 能被設定為主動值，以支援 IME。 (繼承來源 Control) |
| CanFocus |
會獲得一個值，表示控制點是否能獲得焦點。 (繼承來源 Control) |
| CanRaiseEvents |
判斷事件是否能在控制組上引發。 (繼承來源 Control) |
| CanSelect |
會得到一個值，表示是否可以選擇該控制項。 (繼承來源 Control) |
| Capture |
取得或設定一個值，表示控制器是否已捕捉該滑鼠。 (繼承來源 Control) |
| CausesValidation |
覆蓋該財產權 CausesValidation 。 |
| ClientRectangle |
取得代表控制區客戶端區域的矩形。 (繼承來源 Control) |
| ClientSize |
取得或設定控制區客戶區域的高度與寬度。 (繼承來源 Control) |
| CompanyName |
取得包含控制權的公司名稱或應用程式的創建者名稱。 (繼承來源 Control) |
| Container |
得到 IContainer 包含 Component的 。 (繼承來源 Component) |
| ContainsFocus |
會獲得一個值，表示該控制項或其子控制項目前是否擁有輸入焦點。 (繼承來源 Control) |
| ContextMenu |
已淘汰.
取得或設定與控制鍵相關的捷徑選單。 (繼承來源 Control) |
| ContextMenuStrip |
取得或設定 ContextMenuStrip 與此控制相關聯的 (繼承來源 Control) |
| Controls |
取得控制中包含的控制項集合。 (繼承來源 Control) |
| Created |
會得到一個值，表示控制是否已被建立。 (繼承來源 Control) |
| CreateParams |
覆蓋該財產權 CreateParams 。 |
| Cursor |
當滑鼠指標位於控制器上時，會顯示或設定游標。 (繼承來源 Control) |
| DataBindings |
取得控制項的資料綁定。 (繼承來源 Control) |
| DataContext |
取得或設定資料上下文以進行資料綁定。 這是一個環境音屬性。 (繼承來源 Control) |
| DefaultCursor |
取得或設定控制鍵的預設游標。 (繼承來源 Control) |
| DefaultImeMode |
會取得一個值，指示輸入法編輯器（IME） PictureBox的模式。 |
| DefaultMargin |
取得預設控制點間設定的像素空間。 (繼承來源 Control) |
| DefaultMaximumSize |
取得控制項預設最大大小的長度與高度（像素數）。 (繼承來源 Control) |
| DefaultMinimumSize |
取得控制項預設最小大小的長度與高度（像素）。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的預設內部間距（像素）。 (繼承來源 Control) |
| DefaultSize |
會得到預設大小的控制器。 |
| DesignMode |
會得到一個值，表示目前 Component 是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項所在顯示器的 DPI 值。 (繼承來源 Control) |
| DisplayRectangle |
取得代表控制器顯示區域的矩形。 (繼承來源 Control) |
| Disposing |
會取得一個值，表示基底 Control 類別是否正在處理中。 (繼承來源 Control) |
| Dock |
取得或設定哪些控制邊界對接到其父控制，並決定控制點如何與父控制進行調整大小。 (繼承來源 Control) |
| DoubleBuffered |
會取得或設定一個值，指示該控制器是否應該使用次級緩衝區重新繪製表面以減少或防止閃爍。 (繼承來源 Control) |
| Enabled |
取得或設定一個值，表示控制項是否能回應使用者互動。 (繼承來源 Control) |
| ErrorImage |
當影像載入過程中發生錯誤或影像載入被取消時，會取得或設定該影像顯示。 |
| Events |
會取得與此 Component連結的事件處理程序清單。 (繼承來源 Component) |
| Focused |
會得到一個值，表示控制器是否有輸入焦點。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示文字的字型。 |
| FontHeight |
取得或設定控制鍵字型的高度。 (繼承來源 Control) |
| ForeColor |
覆蓋該財產權 ForeColor 。 |
| Handle |
它會得到控制項綁定的視窗把手。 (繼承來源 Control) |
| HasChildren |
會取得一個值，表示該控制是否包含一個或多個子控制項。 (繼承來源 Control) |
| Height |
取得或設定控制點的高度。 (繼承來源 Control) |
| Image |
取得或設定由 顯示的 PictureBox影像。 |
| ImageLocation |
取得或設定圖片在 PictureBox. |
| ImeMode |
取得或設定此控制項所支援的輸入法編輯器（IME）模式。 |
| ImeModeBase |
取得或設定控制的 IME 模式。 (繼承來源 Control) |
| InitialImage |
當主影像載入時，會取得或設定控制中顯示的 PictureBox 影像。 |
| InvokeRequired |
會獲得一個值，表示呼叫者在呼叫控制項時是否必須呼叫呼叫方法，因為呼叫者使用的執行緒與該控制項建立的執行緒不同。 (繼承來源 Control) |
| IsAccessible |
取得或設定一個值，指示該控制項是否對無障礙應用程式可見。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
顯示該控制點的前祖是否被設置在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
會有一個值，表示控制權是否已被處理掉。 (繼承來源 Control) |
| IsHandleCreated |
會得到一個值，表示該控制項是否有與其相關的 handle。 (繼承來源 Control) |
| IsMirrored |
會得到一個值，表示該控制是否為鏡像。 (繼承來源 Control) |
| LayoutEngine |
會取得控制點的佈局引擎的快取實例。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊與容器客戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| Location |
取得或設定控制器左上角相對於容器左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制區之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定的上限是可以指定的上限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| MinimumSize |
取得或設定的尺寸是可指定的下限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| Name |
取得或設定控制的名稱。 (繼承來源 Control) |
| Padding |
在控制範圍內設置或設置填充。 (繼承來源 Control) |
| Parent |
取得或設定控制的父容器。 (繼承來源 Control) |
| PreferredSize |
大小相當於一個長方形區域，控制器可以放進去。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組裝版本。 (繼承來源 Control) |
| RecreatingHandle |
會取得一個值，表示該控制項目前是否正在重新建立其句柄。 (繼承來源 Control) |
| Region |
取得或設定與控制項相關的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
該物業現已過時。 (繼承來源 Control) |
| ResizeRedraw |
會取得或設定一個值，表示控制項在調整時是否會自行重新繪製。 (繼承來源 Control) |
| Right |
取得控制器右邊與容器用戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| RightToLeft |
取得或設定一個值，表示控制項元素是否對齊以支援使用右至左語言的區域。 |
| ScaleChildren |
會得到一個決定子控制項縮放的值。 (繼承來源 Control) |
| ShowFocusCues |
會得到一個值，指示控制器是否應該顯示焦點矩形。 (繼承來源 Control) |
| ShowKeyboardCues |
會取得一個值，表示使用者介面是否處於顯示或隱藏鍵盤加速器的適當狀態。 (繼承來源 Control) |
| Site |
取得或設定控制點。 (繼承來源 Control) |
| Size |
設定控制器的高度與寬度。 (繼承來源 Control) |
| SizeMode |
顯示影像的顯示方式。 |
| TabIndex |
取得或設定 tab 索引值。 |
| TabStop |
會取得或設定一個值，指示使用者是否可以透過 TAB 鍵將焦點分配給此控制項。 |
| Tag |
取得或設定包含控制項資料的物件。 (繼承來源 Control) |
| Text |
取得或設定 的 PictureBox文字。 |
| Top |
取得或設定控制面板頂端與容器用戶端區域頂端之間的距離（以像素為單位）。 (繼承來源 Control) |
| TopLevelControl |
取得沒有被其他 Windows Forms 控制項保護的父控制權。 通常，這是控制所包含的最 Form 外層。 (繼承來源 Control) |
| UseWaitCursor |
取得或設定一個值，指示是否使用等待游標來控制目前的控制項及所有子控制項。 (繼承來源 Control) |
| Visible |
取得或設定一個值，表示該控制項及其所有子控制項是否被顯示。 (繼承來源 Control) |
| WaitOnLoad |
取得或設定一個值，表示影像是否同步載入。 |
| Width |
設定或設定控制寬度。 (繼承來源 Control) |
| WindowTarget |
此性質對此類別無關。 (繼承來源 Control) |
方法
事件
| 名稱 | Description |
|---|---|
| AutoSizeChanged |
這個活動與本班無關。 (繼承來源 Control) |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
發生於 BackgroundImage 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageLayoutChanged |
當房產變更時 BackgroundImageLayout 發生。 (繼承來源 Control) |
| BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
| CausesValidationChanged |
覆蓋該財產權 CausesValidationChanged 。 |
| ChangeUICues |
當焦點或鍵盤使用者介面（UI）提示改變時，會發生這種情況。 (繼承來源 Control) |
| Click |
當按下控制器時會發生。 (繼承來源 Control) |
| ClientSizeChanged |
發生於 ClientSize 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuChanged |
已淘汰.
發生於 ContextMenu 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuStripChanged |
發生於 ContextMenuStrip 屬性的值變更時。 (繼承來源 Control) |
| ControlAdded |
當新增控制項加入 Control.ControlCollection時，會發生。 (繼承來源 Control) |
| ControlRemoved |
當控制項從 中移除 Control.ControlCollection時發生。 (繼承來源 Control) |
| CursorChanged |
發生於 Cursor 屬性的值變更時。 (繼承來源 Control) |
| DataContextChanged |
發生於 DataContext 屬性的值變更時。 (繼承來源 Control) |
| Disposed |
當元件被呼叫方法 Dispose() 時會發生。 (繼承來源 Component) |
| DockChanged |
發生於 Dock 屬性的值變更時。 (繼承來源 Control) |
| DoubleClick |
當雙擊按鈕時會發生。 (繼承來源 Control) |
| DpiChangedAfterParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 改變後，程式方式更改時會發生。 (繼承來源 Control) |
| DpiChangedBeforeParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 變更事件尚未發生之前，程式化地更改時就會發生。 (繼承來源 Control) |
| DragDrop |
當拖放操作完成時會發生。 (繼承來源 Control) |
| DragEnter |
當物體被拖入控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragLeave |
當物體被拖出控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragOver |
當物體被拖過控制範圍時會發生。 (繼承來源 Control) |
| EnabledChanged |
發生於 Enabled 屬性值變更時。 (繼承來源 Control) |
| Enter |
覆蓋該財產權 Enter 。 |
| FontChanged |
發生於 Font 屬性的值變更時。 |
| ForeColorChanged |
發生於 ForeColor 屬性的值變更時。 |
| GiveFeedback |
發生在拖曳操作期間。 (繼承來源 Control) |
| GotFocus |
當控制裝置被聚焦時發生。 (繼承來源 Control) |
| HandleCreated |
當控制器被建立把柄時，會發生這種情況。 (繼承來源 Control) |
| HandleDestroyed |
當控制器的把手正在被摧毀時，會發生這種情況。 (繼承來源 Control) |
| HelpRequested |
當使用者請求控制權協助時會發生。 (繼承來源 Control) |
| ImeModeChanged |
發生於 ImeMode 屬性的值變更時。 |
| Invalidated |
當控制器顯示需要重新繪製時，會發生這種情況。 (繼承來源 Control) |
| KeyDown |
當控制器有焦點時按下按鍵時會發生。 |
| KeyPress |
當控制器有焦點時按下按鍵時會發生。 |
| KeyUp |
當控制器有焦點時放開鑰匙時會發生。 |
| Layout |
當控制項應該重新定位其子控制項時，會發生這種情況。 (繼承來源 Control) |
| Leave |
當輸入焦點離開 。PictureBox |
| LoadCompleted |
當非同步映像載入操作完成、被取消或提出例外時，會發生這種情況。 |
| LoadProgressChanged |
當非同步影像載入操作的進度改變時，會發生這種情況。 |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
當控制失焦時會發生。 (繼承來源 Control) |
| MarginChanged |
當對照組的邊界改變時會發生。 (繼承來源 Control) |
| MouseCaptureChanged |
當控制組失去滑鼠捕捉時會發生。 (繼承來源 Control) |
| MouseClick |
當滑鼠點擊控制鍵時會發生。 (繼承來源 Control) |
| MouseDoubleClick |
當滑鼠雙擊控制鍵時會發生。 (繼承來源 Control) |
| MouseDown |
當滑鼠指標放在控制器上，按下滑鼠按鈕時會發生。 (繼承來源 Control) |
| MouseEnter |
當滑鼠指標進入控制鍵時會發生。 (繼承來源 Control) |
| MouseHover |
當滑鼠指標放在控制器上時會發生。 (繼承來源 Control) |
| MouseLeave |
當滑鼠指標離開控制鍵時會發生。 (繼承來源 Control) |
| MouseMove |
當滑鼠指標移到控制器上時會發生。 (繼承來源 Control) |
| MouseUp |
當滑鼠指標放在控制器上方並放開滑鼠按鈕時，會發生這種情況。 (繼承來源 Control) |
| MouseWheel |
當滑鼠滾輪移動時，控制器仍保持對焦。 (繼承來源 Control) |
| Move |
當控制桿移動時會發生。 (繼承來源 Control) |
| PaddingChanged |
當控制器的填充物改變時會發生。 (繼承來源 Control) |
| Paint |
當控制鍵重新繪製時會發生。 (繼承來源 Control) |
| ParentChanged |
當房產價值變動時 Parent 發生。 (繼承來源 Control) |
| PreviewKeyDown |
當按鍵在該控制鍵上時，會發生在事件發生 KeyDown 前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
當 AccessibleObject 提供無障礙應用程式協助時，會發生這種情況。 (繼承來源 Control) |
| QueryContinueDrag |
發生在拖放操作期間，使拖曳源判斷是否應該取消拖放操作。 (繼承來源 Control) |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
當控制大小被調整時會發生。 (繼承來源 Control) |
| RightToLeftChanged |
發生於 RightToLeft 屬性的值變更時。 |
| SizeChanged |
當房產價值變動時 Size 發生。 (繼承來源 Control) |
| SizeModeChanged |
發生在變化時 SizeMode 。 |
| StyleChanged |
當控制風格改變時會發生。 (繼承來源 Control) |
| SystemColorsChanged |
當系統顏色改變時會發生。 (繼承來源 Control) |
| TabIndexChanged |
發生於 TabIndex 屬性的值變更時。 |
| TabStopChanged |
發生於 TabStop 屬性的值變更時。 |
| TextChanged |
發生於 Text 屬性的值變更時。 |
| Validated |
當控制驗證完成時發生。 (繼承來源 Control) |
| Validating |
當對照組進行驗證時會發生。 (繼承來源 Control) |
| VisibleChanged |
當房產價值變動時 Visible 發生。 (繼承來源 Control) |
明確介面實作
| 名稱 | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
| ISupportInitialize.BeginInit() |
會向物件發出初始化開始的訊號。 |
| ISupportInitialize.EndInit() |
向物件發出初始化完成的訊號。 |
