Pattern di controllo valore
Vengono descritte le linee guida e le convenzioni per l'implementazione di IValueProvider, incluse informazioni su proprietà e metodi. Il pattern di controllo valore viene utilizzato 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.
Questo argomento contiene 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 value, tenere presenti le linee guida e le convenzioni seguenti:
I controlli, ad esempio una voce di 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 valore se gli elementi figlio sono modificabili. L'immagine seguente mostra un esempio di voce di elenco modificabile.
voce di elenco modificabile
I controlli di modifica a riga singola e a più righe devono implementare ITextProvider per esporre il contenuto di sola lettura.
I controlli di modifica su più righe devono implementare IValueProvider se il contenuto può essere modificato.
IValueProvider non supporta il recupero di informazioni di formattazione o valori di sottostringa. Implementare ITextProvider in questi scenari.
IValueProvider deve essere implementato da controlli quali il controllo selezione colori da Microsoft Word (vedere l'immagine seguente), che supporta il mapping di stringhe tra un valore di colore (ad esempio" giallo) e un valore interno RGB equivalente.
Per un controllo deve essere impostata la proprietà IsEnabled su TRUE e la proprietà ITextProvider::IsReadOnly impostata su FALSE prima di consentire una chiamata a ITextProvider::SetValue.
Membri obbligatori per IValueProvider
Per implementare l'interfacciaIValueProvidersono 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 ha eventi associati.
Argomenti correlati
-
tipi di controllo e i relativi modelli di controllo supportati
-
Panoramica modelli di controllo di automazione interfaccia utente