核取方塊使用者介面對話方塊
[核取方塊] 對話方塊最多可為使用者顯示四個選項，並於安裝時傳回這些選項的值。 有三種可用的 [核取方塊] 對話方塊：核取方塊 (A)、核取方塊 (B) 和核取方塊 (C)。 這三種對話方塊是相同的，每一種僅可單次加入各個部署專案中。
對話方塊有四個含關聯標籤的核取方塊，加上額外的標籤以便為使用者顯示資訊。 這些標籤的文字是在 [屬性] 視窗中於設計階段指定。 可為各個核取方塊提供額外屬性，以便控制可視性、設定預設值，並傳回值。
在下列的圖例中，將顯示一般的 [核取方塊] 對話方塊，如同安裝時所顯示的一樣。
核取方塊對話方塊
.gif "部署 UI 開頭顯示畫面")
屬性
下列屬性可於 [核取方塊] 對話方塊中使用。
屬性 |
描述 |
|---|---|
BannerBitmap |
指定要在橫幅區域顯示的點陣圖或 JPEG 影像。 在上面的圖例中顯示的是預設點陣圖。 如需詳細資訊，請參閱 BannerBitmap 屬性。 |
BannerText |
指定要在橫幅區域顯示的文字。 在上面的圖例中，這會對應到「這是橫幅文字」。 |
BodyText |
指定要在核取方塊上方顯示的文字。 在上面的圖例中，這對應到「這是本文文字」。 |
Checkbox1Label |
指定要在第一個核取方塊旁顯示的文字。 在上面的圖例中，這會對應到「第一個選取區」。 |
Checkbox1Property |
指定用來擷取第一個核取方塊值 (Checked 或 Unchecked) 的屬性名稱。 這個屬性可以視情況使用。 |
Checkbox1Value |
指定第一個核取方塊的初始值 (Checked 或 Unchecked)。 |
Checkbox1Visible |
指定第一個核取方塊是否為可見的或隱藏的。 這應將會顯示一或多個核取方塊的對話方塊設定為 true。 |
Checkbox2Label |
指定要在第二個核取方塊旁顯示的文字。 在上面的圖例中，這對應到「第二個選取區」。 |
Checkbox2Property |
指定用來擷取第二個核取方塊值 (Checked 或 Unchecked) 的屬性名稱。 這個屬性可以視情況使用。 |
Checkbox2Value |
指定第二個核取方塊的初始值 (Checked 或 Unchecked)。 |
Checkbox2Visible |
指定第二個核取方塊為可視或隱藏。 應該將顯示兩個或多個核取方塊的對話方塊設定為 true，或是將顯示單一核取方塊的對話方塊設定為 false。 |
Checkbox3Label |
指定要在第三個核取方塊旁顯示的文字。 在上面的圖例中，這會對應到「第三個選取區」。 |
Checkbox3Property |
指定用來擷取第三個核取方塊值 (Checked 或 Unchecked) 的屬性名稱。 這個屬性可以視情況使用。 |
Checkbox3Value |
指定第三個核取方塊的初始值 (Checked 或 Unchecked)。 |
Checkbox3Visible |
指定第三個核取方塊為可視或隱藏。 應該將顯示三個或多個核取方塊的對話方塊設定為 true，或是將顯示兩個或更少核取方塊的對話方塊設定為 false。 |
Checkbox4Label |
指定要在第四個核取方塊旁顯示的文字。 在上面的圖例中，這會對應到「第四個選取區」。 |
Checkbox4Property |
指定用來擷取第四個核取方塊值 (Checked 或 Unchecked) 的屬性名稱。 這個屬性可以視情況使用。 |
Checkbox4Value |
指定第四個核取方塊的初始值 (Checked 或 Unchecked)。 |
Checkbox4Visible |
指定第四個核取方塊為可視或隱藏。 應該將顯示四個或多個核取方塊的對話方塊設定為 true，或是將顯示三個或更少核取方塊的對話方塊設定為 false。 |
控制核取方塊對話方塊的外觀
有數種屬性可控制 [核取方塊] 對話方塊在安裝時對使用者顯示的方式。
[BannerBitmap] 屬性可控制對話方塊右上角所顯示的影像。 影像的位置和大小是固定的。
.gif "秘訣")
秘訣同一個安裝程式中所有的對話方塊都應使用相同的影像檔，以維持使用者介面的一致。
[BannerText] 屬性可控制對話方塊上方橫幅所顯示的文字。 位置、大小和字型大小都已固定。 文字會自動換行，但不可超過兩行。
[BodyText] 屬性可控制對話方塊橫幅部分正下方所顯示的文字。 位置和字型大小都已固定。 文字會自動換行，但不可超過四行。
CheckboxNLabel 屬性可控制在核取方塊標籤中的文字。 位置、大小和字型大小都已固定，文字不會自動換行。
秘訣對於可能具有當地語系化的對話方塊，將預留較多空間，以便展開文字。 經過翻譯之後，某種語言中的某個字可能會在另一種語言中成為較長的字，導致文字遭切除。
利用核取方塊對話方塊屬性來擷取使用者選項
包含 [核取方塊] 對話方塊的安裝程式執行時，使用者可以變更任何可視核取方塊的值，之後您便可使用該選項來控制另一個安裝階段。
例如，您可以建立 [核取方塊] 對話方塊，讓使用者選擇安裝兩個選擇性檔案 (檔案 A 和檔案 B)。 在這種情況下，您可以將 Checkbox1Label 屬性設為「Install File A」，並將 Checkbox2Label 屬性設為「Install File B」。 既然您只需要兩個核取方塊，也可以將 [Checkbox3Visible] 和 [Checkbox4Visible] 屬性設定為 false。
如果您認為使用者通常會安裝檔案 A，那麼可以將 [Checkbox1Value] 屬性設定為 Checked，以預設選取。
在 [檔案系統編輯器] 中，您可以將檔案 A 的 [Condition] 屬性設定為 [Checkbox1Property] 屬性的值，同時將檔案 B 的 [Condition] 屬性設定為 [Checkbox2Property] 屬性的值。
在安裝過程中，將評估各個檔案的 [Condition] 屬性。 如果使用者選取了核取方塊，則條件會評估為 true，並安裝檔案，反之則不安裝。