Pattern di controllo valore
Vengono descritte le linee guida e le convenzioni per l'implementazione di IValueProvider, incluse informazioni sulle proprietà e sui metodi. Il pattern di controllo Value viene usato per supportare i controlli con un valore intrinseco che non si estende su un intervallo e che possono essere rappresentati come stringa.
La stringa del valore può essere modificabile, a seconda del controllo e delle relative impostazioni. Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.
In questo argomento sono contenute le sezioni seguenti.
- Linee guida e convenzioni di implementazione
- Membri obbligatori per IValueProvider
- Argomenti correlati
Linee guida e convenzioni di implementazione
Quando si implementa il pattern di controllo Valore , tenere presenti le linee guida e le convenzioni seguenti:
I controlli, ad esempio un elemento elenco o un elemento della struttura ad albero, devono supportare il pattern di controllo Valore se il valore di uno degli elementi è modificabile, indipendentemente dalla modalità di modifica corrente del controllo. Il controllo padre deve supportare anche il pattern di controllo Value se gli elementi figlio sono modificabili. L'immagine seguente mostra un esempio di elemento di elenco modificabile.
I controlli di modifica a riga singola e a più righe devono implementare ITextProvider per esporre il contenuto di sola lettura.
Se è possibile modificare il contenuto, i controlli di modifica su più righe devono implementare IValueProvider .
IValueProvider non supporta il recupero di informazioni di formattazione o valori di sottostringa. Implementare ITextProvider in questi scenari.
IValueProvider deve essere implementato da controlli come il controllo selezione colori di Microsoft Word (vedere l'immagine seguente), che supporta il mapping di stringhe tra un valore di colore (ad esempio"giallo") e un valore RGB interno equivalente.
Per un controllo deve essere impostata la proprietà IsEnabled su TRUE e la relativa proprietà ITextProvider::IsReadOnly è impostata su FALSE prima di consentire una chiamata a ITextProvider::SetValue.
Membri obbligatori per IValueProvider
Per implementare l'interfaccia IValueProvider sono necessari i metodi e le proprietà seguenti.
| Membri obbligatori | Tipo di membro | Note |
|---|---|---|
| IsReadOnly | Proprietà | Nessuno |
| Valore | Proprietà | Nessuno |
| SetValue | Metodo | Nessuno |
Questo pattern di controllo non è associato a eventi.
Argomenti correlati
-
Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente
-
Panoramica dell'albero di automazione dell'interfaccia utente