圖片框(PictureBox)控制元件用於在表單上顯示影象。該控制元件的Image
屬性允許在設計時或執行時設定影象。
可通過從工具箱中拖動一個PictureBox
控制元件並將其放在表單上來建立一個圖片框。
以下是PictureBox控制元件的一些常用屬性:
編號 | 屬性 | 描述 |
---|---|---|
1 | AllowDrop |
指定圖片框是否接受使用者在其上拖動的資料。 |
2 | ErrorImage |
獲取或指定在影象載入過程中發生錯誤或影象載入被取消時要顯示的影象。 |
3 | Image |
獲取或設定控制元件中顯示的影象。 |
4 | ImageLocation |
獲取或設定控制元件中顯示的影象的路徑或URL。 |
5 | InitialImage |
獲取或設定主影象載入時顯示在控制元件中的影象 |
6 | SizeMode |
確定要在控制元件中顯示的影象的大小。該屬性從PictureBoxSizeMode 列舉中取值,其值為:Normal ,StrechImage ,AutoSize ,CenterImage ,Zoom |
7 | TabIndex |
獲取或設定索引標籤索引值。 |
8 | TabStop |
指定使用者是否能夠使用TAB鍵在圖片框上進行對焦。 |
9 | Text |
獲取或設定圖片框的文字。 |
10 | WaitOnLoad |
指定是否同步載入影象。 |
以下是PictureBox控制元件的一些常用方法:
編號 | 方法 | 描述 |
---|---|---|
1 | CancelAsync |
取消非同步影象載入。 |
2 | Load |
在圖片框中顯示圖片 |
3 | LoadAsync |
非同步載入影象。 |
4 | ToString |
返回表示當前圖片框的字串。 |
以下是PictureBox控制元件的一些常用事件:
編號 | 事件 | 描述 |
---|---|---|
1 | CausesValidationChanged |
重寫Control.CausesValidationChanged 屬性。 |
2 | Click |
在單擊控制元件時發生。 |
3 | Enter |
重寫Control.Enter 屬性。 |
4 | FontChanged |
在Font 屬性的值更改時發生。 |
5 | ForeColorChanged |
在ForeColor 屬性的值更改時發生。 |
6 | KeyDown |
當控制元件具有焦點時按下鍵時發生。 |
7 | KeyPress |
當控制元件具有焦點時按下鍵時發生。 |
8 | KeyUp |
當控制元件擁有焦點時釋放鍵時發生。 |
9 | Leave |
當輸入焦點離開PictureBox 時發生。 |
10 | LoadCompleted |
在非同步映像載入操作完成,取消或引發異常時發生。 |
11 | LoadProgressChanged |
在非同步映像載入操作的進度已更改時發生。 |
12 | Resize |
在控制元件調整大小時發生。 |
13 | RightToLeftChanged |
在RightToLeft 屬性的值更改時發生。 |
14 | SizeChanged |
在Size 屬性值更改時發生。 |
15 | SizeModeChanged |
在SizeMode 更改時發生。 |
16 | TabIndexChanged |
在TabIndex 屬性的值更改時發生。 |
17 | TabStopChanged |
在TabStop 屬性的值更改時發生。 |
18 | TextChanged |
在Text 屬性的值發生更改時發生。 |
在這個例子中,把一個圖片框和一個按鈕控制元件放在表單上。我們將圖片框的圖片屬性設定為dog.png,就像之前使用的那樣。 按鈕Button1
的Click事件被編碼以將影象拉伸到指定的大小,參考以下範例程式碼 -
Public Class Form1
Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
' Set the caption bar text of the form. '
Me.Text = "PictureBox控制元件範例 - tw511.com"
End Sub
Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
PictureBox1.ClientSize = New Size(300, 300)
PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
End Sub
End Class
設計檢視:
當應用程式執行時,它顯示:
點選放大 按鈕結果: