MaskedEdit Control
Il controllo MaskedEdit è un controllo campo di modifica che contiene una maschera nel campo di testo del controllo. È possibile associare il controllo a una proprietà di valore stringa immettendo il nome della proprietà nella colonna Proprietà della tabella di controllo.
È possibile utilizzare il controllo MaskedEdit per creare un modello per l'immissione di informazioni da parte dell'utente, ad esempio un numero di telefono o un codice ID prodotto. Ad esempio, la proprietà PIDKEY può essere immessa dall'utente tramite un controllo MaskedEdit specificato impostando la proprietà PIDTemplate su una stringa simile alla seguente:
12345<### -%%%%%%>@@@@@
La stringa definisce il modello di maschera per la voce della proprietà PIDKEY dall'utente. Il segmento visibile della stringa è racchiuso tra parentesi quadre (<>).
Nella tabella seguente è stata identificata la sintassi della maschera.
| Carattere | Significato |
|---|---|
| < | Estremità sinistra del segmento visibile del modello. Questo carattere e tutto a sinistra sono nascosti nell'interfaccia utente. Nel modello non deve essere presente più di un'istanza di questo carattere. |
| > | Estremità destra del segmento visibile del modello. Questo carattere e tutto a destra sono nascosti nell'interfaccia utente. Questo carattere viene sostituito da un trattino durante la convalida. Se è presente un segmento visibile inizia con <, deve essere terminato con un oggetto corrispondente >. |
| # | Questo carattere può essere una cifra (numerale). |
| % | Questo carattere può essere una cifra alternativa (numerale) che consente alla maschera di controllare il modo in cui un'azione personalizzata differenzia i campi. |
| @ | Questo carattere può essere una cifra casuale (numerale). Questo carattere non deve essere visualizzato nella parte visibile del modello. |
| & | Questo carattere può essere qualsiasi carattere. |
| ^ | Questo carattere può essere un carattere alternativo che consente alla maschera di controllare il modo in cui un'azione personalizzata differenzia i campi. |
| ? | Questo carattere può essere un carattere alternativo che consente alla maschera di controllare il modo in cui un'azione personalizzata differenzia i campi. |
| ` | I segni accenti gravi ' (valore ASCII 96) possono rappresentare un carattere alternativo che consente alla maschera di controllare il modo in cui un'azione personalizzata differenzia i campi. |
| _ | Questo carattere è un carattere di sottolineatura letterale. |
| = | Questo carattere è il carattere di terminazione del campo. Deve seguire un oggetto #, %, ^o '. In questo modo viene creata un'altra posizione di input dello stesso tipo delle posizioni precedenti e termina il campo con un separatore '-'. |
Qualsiasi altro carattere viene considerato come costante letterale.
Per i caratteri che possono essere modificati, il controllo crea finestre di modifica separate con una finestra per ogni blocco di caratteri contigui dello stesso tipo.
Attributi di controllo
Per modificare il valore di un attributo che usa un evento, sottoscrivere il controllo a un evento Control nella tabella EventMapping ed elencare l'identificatore dell'attributo nella colonna Attribute. Immettere l'identificatore dell'evento Control nella colonna Event. È possibile utilizzare gli attributi seguenti con il controllo MaskedEdit.
| Attributo | Bit esadecimale | Descrizione |
|---|---|---|
| IndirectPropertyName | Si tratta del nome di una proprietà indiretta associata al controllo . Se il bit dell'attributo indiretto è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Se il bit dell'attributo indiretto è impostato, questo nome è anche il valore della proprietà elencata nella colonna Proprietà della tabella di controllo. | |
| Posizione | Posizione del controllo nella finestra di dialogo. Immettere la larghezza, l'altezza e le coordinate del controllo nell'angolo sinistro del controllo nelle colonne Width, Height, X e Y della tabella di controllo. Usare le unità di installazione per lunghezza e distanza. |
|
| PropertyName | Si tratta del nome della proprietà associata a questo controllo. Se il bit dell'attributo indiretto non è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Questo attributo viene specificato nella colonna Proprietà della tabella di controllo. | |
| PropertyValue | Valore corrente della proprietà visualizzata o modificata da questo controllo. Se il bit dell'attributo indiretto non è impostato, questo è il valore di PropertyName. Se il bit dell'attributo indiretto è impostato, questo è il valore di IndirectPropertyName. Se l'attributo viene modificato, il controllo riflette il nuovo valore. | |
| Text | Per impostare il tipo di carattere e lo stile del carattere di una stringa di testo, anteporre la stringa dei caratteri visualizzati con {\style} o {&style}. Dove style è un identificatore elencato nella colonna Stile della tabella TextStyle. Se nessuno di questi elementi è presente, ma la proprietà DefaultUIFont è definita come uno stile di testo valido, viene utilizzato tale tipo di carattere. La stringa che specifica il modello di mascheramento segue questo prefisso e usa la sintassi descritta in precedenza in questo argomento. | |
| Visible | 0x00000000 0x00000001 |
Controllo nascosto. Controllo visibile. Includere questo bit nella parola bit della colonna Attributes nella tabella di controllo per rendere visibile o nascosto il controllo al momento della creazione. È anche possibile nascondere o visualizzare un controllo utilizzando la tabella ControlCondition. |
| Abilitato | 0x00000000 0x00000002 |
Controllo in uno stato disabilitato. Controllo in uno stato abilitato. Includere questo bit nella parola bit nella colonna Attributi della tabella di controllo per abilitare il controllo alla creazione. È anche possibile abilitare o disabilitare un controllo usando la tabella ControlCondition. |
| Affondata | 0x00000000 0x00000004 |
Visualizza lo stile di visualizzazione predefinito. Visualizza il controllo con un aspetto 3D incassato. Includere questi bit nella parola bit nella colonna Attributi della tabella di controllo. |
| Indiretto | 0x00000000 0x00000008 |
Il controllo visualizza o modifica il valore della proprietà nella colonna Proprietà della tabella di controllo. Il controllo visualizza o modifica il valore della proprietà con l'identificatore elencato nella colonna Proprietà della tabella di controllo. Determina se alla proprietà associata a questo controllo viene fatto riferimento indirettamente. |
Osservazioni:
Il controllo MaskedEdit crea una finestra padre della classe BUTTON con gli stili BS_OWNERDRAW e WS_EX_CONTROLPARENT . Crea diverse finestre figlio in questa finestra.
- Per le parti di testo costanti, crea finestre STATICHE con gli stili SS_LEFT e WS_CHILD .
- Per i campi modificabili, crea una finestra EDIT con gli stili WS_CHILD, WS_BORDER e WS_TABSTOP .
- Per i campi numerici, la finestra ha anche lo stile ES_NUMBER .
I campi alternativi , %e alfanumerici alternativi, ^, ?e ' consentono alle azioni personalizzate di distinguere i campi in modo che possano essere controllati dalla maschera, ad esempio ^ può essere usato per i campi che devono essere maiuscoli.