MaskedEdit 控制件

  • 發行項

MaskedEdit 控件是編輯欄位控制件，其中包含控件文字欄位中的遮罩。 您可以將屬性名稱輸入控件數據表的 Property 資料行，使控件與字串值屬性產生關聯。

您可以使用 MaskedEdit 控制項，為使用者輸入電話號碼或產品識別碼等資訊建立範本。 例如，用戶可透過將 PIDTemplate 屬性設定為如下字串所指定的 MaskedEdit 控制項來輸入 PIDKEY 屬性：

12345<### -%%%>@@@@@

字串會針對使用者的 PIDKEY 屬性專案定義遮罩範本。 字串的可見區段會以一對括弧 （<>） 字元括住。

下表識別出遮罩的語法。

字元 意義
< 範本可見區段的左端。 此字元及其左側的所有內容會隱藏在用戶介面中。 範本中不應該有一個以上的這個字元實例。
> 範本可見區段的右端。 此字元及其右側的所有內容會隱藏在用戶介面中。 此字元會在驗證期間由虛線取代。 如果有可見的區段開頭為 <，則必須以相符 >的終止。
# 此字元可以是數位（數位）。
% 此字元可以是替代數位（數位），可讓遮罩控制自定義動作區分字段的方式。
@ 此字元可以是隨機數位（數位）。此字元不應該出現在範本的可見部分。
& 此字元可以是任何字元。
^ 此字元可以是替代字元，可讓遮罩控制自定義動作區分字段的方式。
? 此字元可以是替代字元，可讓遮罩控制自定義動作區分字段的方式。
` 嚴重強調符號 ' （ASCII 值 96） 可以代表替代字元，讓遮罩控制自定義動作區分字段的方式。
_ 此字元是常值底線字元。
= 此字元是欄位終止符。 這必須遵循 #、% ^或 '。 這會建立與上述位置相同類型的一個輸入位置，並以 『-』 分隔符終止欄位。

 

任何其他字元都會被視為常值常數。

針對可以編輯的字元，控件會針對相同類型之連續字元的每個區塊建立一個視窗，並建立個別的編輯視窗。

控件屬性

若要變更使用事件的屬性值，請將控件訂閱至 EventMapping Table 中的 Control 事件，並在 Attribute 數據行中列出屬性識別碼。 在 [事件] 數據行中輸入 Control 事件的識別碼。 您可以使用下列屬性搭配 MaskedEdit 控制項。

屬性 十六進位位 描述
IndirectPropertyName 這是與控件相關聯的間接屬性名稱。 如果已設定間接屬性位，控件會顯示或變更具有此名稱的屬性值。 如果設定間接屬性位，這個名稱也是控件數據表的 Property 數據行中列出的屬性值。
位置 控件在對話框中的位置。 在控件表格的 Width、Height、X 和 Y 資料行中，輸入控件左角的控件寬度、高度和座標。 針對長度和距離使用 安裝程序單位 。
PropertyName 這是與這個控件相關聯的屬性名稱。 如果未設定間接屬性位，控件會顯示或變更具有此名稱的屬性值。 此屬性是在 [控件數據表] 的 [屬性] 資料行中指定。
PropertyValue 這個控件所顯示或變更之屬性的目前值。 如果未設定間接屬性位，這是 PropertyName 的值。 如果設定間接屬性位，這是 IndirectPropertyName 的值。 如果屬性變更，控件會反映新的值。
Text 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle Table 的 Style 數據行中列出的標識符。 如果其中兩者都不存在，但 DefaultUIFont 屬性會定義為有效的文字樣式，則會使用該字型。 指定遮罩範本的字串會遵循此前置詞，並使用本主題先前所述的語法。
Visible 0x00000000 0x00000001
 隱藏的控件。 可見控制件。
將這個位包含在控件數據表中 Attributes 數據行的位字中，讓控件在建立時可見或隱藏。
您也可以使用 ControlCondition 資料表來隱藏或顯示控件。
已啟用 0x00000000 0x00000002
 處於停用狀態的控制件。 處於啟用狀態的控制件。
在控件數據表的 [屬性] 數據行中包含此位，以在建立時啟用控件。
您也可以使用 ControlCondition 數據表來啟用或停用控件。
沉沒 0x00000000 0x00000004
 顯示預設的視覺化樣式。 顯示具有沉沒、立體外觀的控件。
在控件數據表的 [屬性] 資料行中，將這些位包含在位字中。
間接 0x00000000 0x00000008
 控制項會顯示或變更控制元件資料表的 [屬性] 資料行中的 屬性值。 控件會顯示或變更屬性的值，其標識符列在控件數據表的 Property 數據行中。
判斷與這個控件相關聯的屬性是否間接參考。

 

備註

MaskedEdit 控制項會使用BS_OWNERDRAW和WS_EX_CONTROLPARENT樣式，建立 BUTTON 類別的一個父視窗。 它會在此視窗中建立數個子視窗。

  • 針對常數文字元件，它會使用SS_LEFT和WS_CHILD樣式建立 STATIC 視窗。
  • 針對可編輯的欄位，它會使用WS_CHILD、WS_BORDER和WS_TABSTOP樣式來建立EDIT視窗。
  • 對於數值欄位，視窗也有 ES_NUMBER 樣式。

替代數位、% 和替代英數位元 ^、？和 ' 欄位允許自定義動作以遮罩控制的方式區分欄位，例如 ^ 可用於應該為大寫的欄位。