FileListBox

FileListBox 控制項，在運行時，在 Path 屬性指定的目錄中，FileListBox 控制項將檔案定位並列舉出來。

基本介紹

• 外文名：FileListBox
• 用來：顯示所選擇檔案類型的檔案列表
• 說明：置List、ListCount 和 ListIndex
• 語法：object.Appearance

控制項介紹

在運行時，在 Path 屬性指定的目錄中，FileListBox 控制項將檔案定位並列舉出來。該控制項用來顯示所選擇檔案類型的檔案列表。例如，可以在應用程式中創建對話框，通過它選擇一個檔案或者一組檔案。

語法

FileListBox

說明

設定 List、ListCount 和 ListIndex 屬性，可以訪問列表中的項目。如果需要顯示 DirListBox 和 DriveListBox 控制項，那么可以編寫代碼，使它們與 FileListBox 控制項同步，並使它們之間彼此同步。Appearance 屬性 返回或設定 MDIForm 或 Form 對象上的控制項在設計時的繪圖風格。在運行時是唯讀的。

語法

object.Appearance

object 所在處代表一個對象表達式，其值是“套用於”列表中的一個對象。

設定值

Appearance 屬性的設定值是：

設定值	描述
0	平面繪製控制項和沒有可視化效果的窗體。
1	（預設值）3D。帶有三維效果的繪製控制項。

說明

如果在設計時將其設定為 1，那么 Appearance 屬性在畫出控制項時帶有三維效果。如果窗體的 BorderStyle 屬性被設定為固定雙框線（vbFixedDouble，或 3），窗體的標題和框線也是以有三維效果的方式繪畫的。將 Appearance 屬性設定為 1，也導致窗體及其控制項的 BackColor 屬性被設定為這樣的顏色，該顏色是為作業系統的“顯示屬性”對話框的“外觀”選項卡中的 3D 對象選定的。

將 MDIForm 對象的 Appearance 屬性設定為 1，只對 MDI 父窗體產生影響。想要在 MDI 子窗體上具有三維效果，必須將每個子窗體的 Appearance 屬性設定為 1。

Archive、Hidden、Normal 和 System 屬性 設定或返回一值，決定 FileListBox 是否以檔案、隱藏、普通或是系統屬性來顯示檔案。

語法

object.Archive [= boolean]

object.Hidden [= boolean]

object.Normal [= boolean]

object.System [= boolean]

Archive，Hidden，Normal 和 System 屬性語法包含下面部分：

部分	描述
object	對象表達式，其值是“套用於”列表中的一個對象。
Boolean	布爾表達式，指定顯示檔案的類型，“設定值”中有詳細描述。

設定值

boolean 的設定值為:

設定值	描述
True	（檔案和普通檔案的預設值）以FileListBoxs 控制項的屬性特徵顯示檔案。
False	（隱藏和系統檔案的預設值）不以 FileListBoxs 控制項的屬性特徵顯示檔案。

說明

基於運行系統使用的標準檔案特徵，可以用這些屬性來指定在 FileListBox 控制項中所顯示檔案的類型。運行時在程式中設定這些屬性中的任一個都會重設 FileListBox 控制項使其只顯示具有指定屬性的檔案。

例如，在查找和替換操作中，可以通過設定 System 屬性為 True、而其它屬性為 False，只顯示系統檔案；或者，作為檔案備份過程的一部分，可以設定 Archive 屬性為 True，以便只列出以前備份後修改過的檔案。

BackColor、ForeColor 屬性 BackColor－返回或設定對象的背景顏色。 ForeColor－返回或設定在對象里顯示圖片和文本的前景顏色。 語法

object.BackColor [= color]

object.ForeColor [= color]

BackColor 和 ForeColor 屬性語法包含下面部分：

部分	描述
object	對象表達式，其值是“套用於”列表中的一個對象。
color	值或常數，確定對象前景或背景的顏色，“設定值”中有詳細說明。

設定值

Visual Basic 用 Microsoft Windows 運行環境的紅-綠-藍 (RGB) 顏色方案。color 的設定值如下：

設定值	描述
標準 RGB 顏色	使用調色板或在代碼中使用 RGB 或 QBColor 函式指定的顏色。
系統預設顏色	由對象瀏覽器中的 Visual Basic (VB) 對象庫所列的系統顏色常數指定的顏色。Windows 運行環境替換使用用戶在控制臺設定值中的選擇。

對所有的窗體和控制項，在設計時的預設設定值如下：

BackColor－設定為由常數 vbWindowBackground 定義的系統預設顏色。 ForeColor－設定為由常數 vbWindowText 定義的系統預設顏色。 說明

在 Label 和 Shape，控制項中，如果 BackStyle 屬性的設定值為 0（透明），則忽略 BackColor 屬性。

如果在 Form 對象或 Picturebox 控制項中設定 BackColor 屬性，則所有的文本和圖片，包括指定的圖片，都被擦除。設定 ForeColor 屬性值不會影響已經繪出的圖片或列印輸出。在其它的所有控制項中，螢幕的顏色會立即改變。

標準 RGB 顏色的有效取值範圍是 0 到 16,777,215 (&HFFFFFF)。該範圍內數的高位元組為 0；較低的 3 個位元組，從最低位元組到最高位元組依次決定紅、綠和藍的量。紅、綠和藍的成分，分別由一個介於 0 與 255 (&HFF) 之間的數來表示。如果最高位元組不為 0，Visual Basic 將使用系統顏色，這些顏色由用戶的控制臺設定值和由對象瀏覽器中的 Visual Basic (VB) 對象庫所列出的常數來確定。

在 Windows 運行環境中顯示文本，文本和背景的顏色必須都是原色。如果所選擇的文本或背景顏色沒有顯示出來，則選擇顏色中可能有抖動色－也就是說，最多由三種不同顏色的像素組成的顏色。如果對文本或背景選擇了抖動色，則會用最接近的原色來代替。

Container 屬性 返回或設定 Form 上控制項的容器。在設計時不能使用。

語法

Set object.Container [= container]

Container 屬性的語法包含下面部分：

部分	描述
object	對象表達式，其值是“套用於”列表中的一個對象。
container	一個對象表達式其值是能夠作為別的控制項容器使用的對象，按照說明的描述。

說明

下面的控制項能夠容納別的控制項：

Frame 控制項PictureBox 控制項.SSTab 控制項

DragIcon 屬性

返回或設定圖示，它將在拖放操作中作為指針顯示。

語法

object.DragIcon [= icon]

DragIcon 屬性語法包含下面部分：

部分	描述
Object	對象表達式，其值是“套用於”列表中的一個對象。
Icon	任何返回圖示的程式引用，例如引用窗體圖示 (Form1.Icon)，引用另外控制項的 DragIcon 屬性 (Text1.DragIcon)，或是LoadPicture 函式。

設定值

icon 的設定值如下:

設定值	描述
(none)	（預設值）矩形框內的箭頭指針。
Icon	自定義的滑鼠指針。在設計時用屬性視窗設定圖示。運行時可以用 LoadPicture 函式。所載入的檔案必須有 .ico 檔案擴展名和格式。

說明

在拖放操作中，用 DragIcon 屬性可以提供可見的信息反饋─例如，它可以指定原控制項在一個適當的目標之上。DragIcon 屬性在用戶開始拖放操作時起作用。典型做法是把 DragIcon 設定為 MouseDown 或 DragOver 事件過程的一部分。

注意 運行時，DragIcon 屬性可以設定為任何對象的 DragIcon 或 Icon 屬性，或者可以用 LoadPicture函式返回的圖示給它賦值。

在運行中，把一個控制項的 Picture 屬性值賦給另一個控制項的 DragIcon 屬性時， Picture 屬性必須包含一個 .ico 檔案，而不是 .bmp 檔案。

FileName 屬性 vbproFillColor

返回或設定所選檔案的路徑和檔案名稱。對於 FileListBox 控制項該屬性在設計時 不可用。

語法

object.FileName [= pathname]

FileName 屬性語法包含下面部分：

部分	描述
Object	對象表達式，其值是“套用於”列表中的一個對象。
Pathname	字元串表達式，指定路徑和檔案名稱。

說明

運行時創建控制項時， FileName 屬性設定為 0 長度字元串 ("")，表示當前沒有選擇檔案。

在 CommonDialog 控制項里，可以在打開對話框之前設定 FileName 屬性以設定初始檔案名稱。

讀該屬性，返回當前從列表中選擇的檔案名稱。路徑用 Path 屬性單獨檢索。在功能上，該值與 List(ListIndex) 等價。如果沒有選擇檔案，FileName 返回 0 長度字元串。

設定這個屬性時： 若字元串中包含驅動器、路徑或模式，則會相應地改變 Drive、Path 和 Pattern 屬性。若字元串中包含存在的檔案名稱（不包含通配符），則會選擇該檔案。改變該屬性值可能會產生一個或多個如下事件：PathChange （如果改變路徑），PatternChange （如果改變模式），或 DblClick （如果指定存在的檔案名稱）。該屬性值可以是限定的網路路徑和檔案名稱，可用下述語法： \\servername\sharename\pathname

Path 屬性 返回或設定當前路徑。在設計時是不可用的。對於 App 對象，在運行時是唯讀的。

語法

object.Path [= pathname]

Path 屬性的語法包含下面部分：

部分	描述
object	對象表達式，其值是“套用於”列表中的一個對象。
pathname	一個用來計算路徑名的字元串表達式。

說明

Path 屬性的值是一個指示路徑的字元串，例如 C:\Ob 或 C:\Windows\System。對於 DirListBox 或 FileListBox 控制項，在運行時當控制項被創建時，其預設值是當前路徑。對於 App 對象，當從開發環境運行該應用程式時 Path 指定 .VBP 工程檔案的路徑，或者當把應用程式當作一個執行檔運行時 Path 指定 .exe 檔案。

當建立一個應用程式的檔案瀏覽器和操作能力時使用這個屬性。設定 Path 屬性對控制項產生的影響與 MS-DOS 的 chdir 命令相似－相關的路徑可以帶有或不帶有驅動器的描述。只有指定帶冒號 (:) 的驅動器才能在那個驅動器上選擇當前目錄。

使用下面的語法，Path 屬性也可以設定限定的網路路徑而不需要驅動器連線：

\\servername\sharename\path

前面的語法將 Drive 屬性改變成了 0 長度的字元串 ("")。

Path 值的改變將產生以下影響：

對於一個 DirListBox 控制項，將產生一個 Change 事件。對於一個 FileListBox 控制項，將產生一個 PathChange 事件. 注意 對於 DirListBox，Path 的返回值與只返回選定內容的 List(ListIndex) 是不同的。

Pattern 屬性返回或設定一個值，該值指示在運行時顯示在 FileListBox 控制項中的檔案名稱。

語法

object.Pattern [= value]

Pattern 屬性的語法包含下面部分：

部分	描述
Object	對象表達式，其值是“套用於”列表中的一個對象。
Value	一個用來指定檔案規格的字元串表達式，例如 "*.*" 或 "*.FRM"。預設值是 "*.*" 它返回所有檔案的列表。除使用通配符外，還能夠使用分號 (;) 分隔的多種模式。例如，"*.exe; *.bat" 將返回所有執行檔和所有 MS-DOS 批處理檔案的列表。

說明

在設計應用程式的檔案瀏覽和操作功能中，Pattern 屬性具有一個關鍵作用。Pattern 與其它檔案控制項屬性結合起來使用，可提供對相似檔案或檔案組資源管理的方法。例如，在一個專門為了啟動別的程式而工作的應用程式中，只會指定 .exe 檔案顯示在檔案列表框中。其它關鍵性的檔案控制項屬性包括 Drive，FileName，和 Path。

Pattern 屬性的值的改變將產生一個 PatternChange 事件。