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

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.

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

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

    illustrazione che mostra il mapping delle stringhe del campione di colore

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

Tipi di controllo e modelli di controllo supportati

Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente

Panoramica dell'albero di automazione dell'interfaccia utente

Modelli di controllo Text e TextRange