VB.Net - PictureBox 控制元件

PictureBox 控制元件用於在窗體上顯示影像。控制元件的 Image 屬性允許您在設計時或執行時設定影像。

讓我們透過從工具箱拖動 PictureBox 控制元件並將其拖放到窗體上來建立一個圖片框。

PictureBox 控制元件的屬性

以下是 PictureBox 控制元件的一些常用屬性：

序號	屬性和描述
1	AllowDrop 指定圖片框是否接受使用者拖放到其上的資料。
2	ErrorImage 獲取或指定在影像載入過程中發生錯誤或影像載入被取消時要顯示的影像。
3	Image 獲取或設定在控制元件中顯示的影像。
4	ImageLocation 獲取或設定控制元件中顯示影像的路徑或 URL。
5	InitialImage 獲取或設定載入主影像時在控制元件中顯示的影像。
6	SizeMode 確定要在控制元件中顯示的影像的大小。此屬性的值取自 PictureBoxSizeMode 列舉，其值如下： Normal - 影像的左上角放置在圖片框的左上角 StretchImage - 允許拉伸影像 AutoSize - 允許調整圖片框大小以適應影像大小 CenterImage - 允許將影像居中顯示在圖片框中 Zoom - 允許增大或減小影像大小以保持大小比例。
7	TabIndex 獲取或設定 Tab 索引值。
8	TabStop 指定使用者是否能夠使用 TAB 鍵將焦點放在圖片框上。
9	Text 獲取或設定圖片框的文字。
10	WaitOnLoad 指定影像是否同步載入。

PictureBox 控制元件的方法

以下是 PictureBox 控制元件的一些常用方法：

序號	方法名稱和描述
1	CancelAsync 取消非同步影像載入。
2	Load 在圖片框中顯示影像
3	LoadAsync 非同步載入影像。
4	ToString 返回表示當前圖片框的字串。

PictureBox 控制元件的事件

以下是 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 屬性的值更改時發生。

示例

在這個例子中，讓我們在窗體上放置一個圖片框和一個按鈕控制元件。我們將圖片框的 Image 屬性設定為 logo.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 = "tutorialspoint.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

設計檢視：

當應用程式執行時，它將顯示：

單擊按鈕後結果為：

vb.net_basic_controls.htm

列印頁面