文字方塊使用者介面對話方塊
[文字方塊] 對話方塊可用來為使用者顯示出四個文字項目欄位，並於安裝時傳回這些欄位的內容。 有三種可用的 [文字方塊] 對話方塊：[文字方塊 (A)]、[文字方塊 (B)] 和 [文字方塊 (C)]。 這三種對話方塊是相同的。每一種僅可單次加入各個部署專案中。
對話方塊包含四個與標籤關聯的文字方塊，加上額外的標籤以便為使用者顯示資訊。 這些標籤的文字是在 [屬性] 視窗中於設計階段指定。 可為各個文字方塊提供額外屬性，以便控制可視性、設定預設文字，並傳回值。
下列圖例中將顯示一般 [文字方塊] 對話方塊，如同安裝時顯示的一樣。
文字方塊對話方塊
.gif "部署 UI 開頭顯示畫面")
屬性
下列屬性可於 [文字方塊] 對話方塊中使用。
屬性 |
描述 |
|---|---|
BannerBitmap |
指定要在橫幅區域顯示的點陣圖或 JPEG 影像。 在上一個圖例中，顯示的是預設點陣圖。 如需詳細資訊，請參閱BannerBitmap 屬性。 |
BannerText |
指定要在橫幅區域顯示的文字。 在上一個圖例中，這會對應到「這是橫幅文字」。 |
BodyText |
指定要在文字方塊上方顯示的文字。 在上一個圖例中，這會對應到「這是本文」。 |
Edit1Label |
指定要在第一個文字方塊旁顯示的文字。 在上一個圖例中，這會對應到「第一個輸入欄位」。 |
Edit1Property |
指定屬性名稱，可用以擷取在第一個文字方塊中輸入的文字。 這個屬性可以視情況使用。 |
Edit1Value |
指定第一個文字方塊的初始值 (文字)。 |
Edit1Visible |
指定第一個文字方塊為可視或隱藏。 這應將會顯示一或多個文字方塊的對話方塊設定為 true。 |
Edit2Label |
指定要在第二個文字方塊上方顯示的文字。 在上一個圖例中，這會對應到「第二個輸入欄位」。 |
Edit2Property |
指定屬性名稱，可用以擷取在第二個文字方塊中輸入的文字。 這個屬性可以視情況使用。 |
Edit2Value |
指定第二個文字方塊的初始值 (文字)。 |
Edit2Visible |
指定第二個文字方塊為可視或隱藏。 這應將顯示二或多個文字方塊的對話方塊設定為 true，或者將顯示單一文字方塊的對話方塊設定為 false。 |
Edit3Label |
指定要在第三個文字方塊上方顯示的文字。 在上一個圖例中，這會對應到「第三個輸入欄位」。 |
Edit3Property |
指定屬性名稱，可用以擷取在第三個文字方塊中輸入的文字。 這個屬性可以視情況使用。 |
Edit3Value |
指定第三個文字方塊的初始值 (文字)。 |
Edit3Visible |
指定第三個文字方塊為可視或隱藏。 這應將顯示三個以上文字方塊的對話方塊設定為 true，或者將顯示二個以下核取方塊的文字方塊設定為 false。 |
Edit4Label |
指定要在第四個文字方塊上方顯示的文字。 在上一個圖例中，這會對應到「第四個輸入欄位」。 |
Edit4Property |
指定屬性名稱，可用以擷取在第四個文字方塊中輸入的文字。 這個屬性可以視情況使用。 |
Edit4Value |
指定第四個文字方塊的初始值 (文字)。 |
Edit4Visible |
指定第四個文字方塊為可視或隱藏。 這應將顯示四個以上文字方塊的對話方塊設定為 true，或者將顯示三個以下文字方塊的對話方塊設定為 false。 |
控制文字方塊對話方塊的外觀
有數種屬性可控制 [文字方塊] 對話方塊在安裝時顯示在使用者面前的方式。
BannerBitmap 屬性可控制對話方塊右上角所顯示的影像。 影像的位置和大小是固定的。
.gif "秘訣")
秘訣同一個安裝程式中所有的對話方塊都應使用相同的影像檔，以維持使用者介面的一致。
[BannerText] 屬性可控制對話方塊上方橫幅所顯示的文字。 位置、大小和字型大小都已固定。 文字會自動換行，但不可超過兩行。
BodyText 屬性可控制對話方塊橫幅區段正下方所顯示的文字。 位置、大小和字型大小都已固定。 文字會自動換行，但不可超過四行。
EditNLabel 屬性會控制文字方塊標籤內的文字。 位置和字型大小都已固定，文字不會自動換行。
秘訣對於可能具有當地語系化的對話方塊，將預留較多空間，以便展開文字。 經過翻譯之後，某種語言中的某個字可能會在另一種語言中成為較長的字，導致文字遭切除。
使用文字方塊對話方塊屬性擷取使用者資訊
當包含 [文字方塊] 對話方塊的安裝程式執行時，使用者即可將資訊輸入任何可見的文字方塊。 然後，您就能在安裝程式的另一階段使用該項資訊。
例如，您可以建立 [文字方塊] 對話方塊，讓使用者輸入工作群組名稱，並儲存在登錄項目中。 在這種情況下，您可將 [Edit1Label] 屬性設定為「輸入您的工作群組名稱」。由於您只需要一個文字方塊，因此也可將 [Edit2Visible]、[Edit3Visible] 和 [Edit4Visible] 屬性設定為 False。
如果您認為使用者通常都會使用名為 "Default" 的工作群組，即可在 [Edit1Value] 屬性中輸入 Default。 此項目便會成為使用者在文字方塊中所看到的初始輸入。
在登錄中，您可以將工作群組名稱登錄項目的 [Condition] 屬性設定為 [Edit1Property] 屬性的值，例如 [EDITA1]。
在安裝過程中，會評估 [Condition] 屬性。 如果使用者輸入名稱 (或接受預設)，則名稱會加入至登錄中；如果是空白的，則不會建立登錄項目。
設定 Managed 自訂動作的條件和值
當您建立 Managed 自訂動作的 UI 時，可以設定條件及值。 但是，您只能根據自訂 UI 屬性使用條件和值。 自訂動作會在安裝程式完成之後執行，所以您無法使用安裝專案的屬性。