Condividi tramite

Pattern di controllo valore

  • Articolo

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

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.

    illustrazione che mostra 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.

    illustrazione che mostra il mapping di stringhe di campioni di colore

  • 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.

tipi di controllo e i relativi modelli di controllo supportati

Panoramica modelli di controllo di automazione interfaccia utente

panoramica dell'albero di automazione interfaccia utente

modelli di controllo Text e TextRange