Controllo SelectionTree
Questo controllo consente a un utente di modificare lo stato di selezione delle funzionalità elencate nella tabella Funzionalità. Il controllo è associato a una proprietà con valori stringa che l'utente può impostare da una finestra di dialogo Sfoglia. È possibile associare il controllo a una proprietà immettendo il nome della proprietà nella colonna Proprietà della tabella Control.
Il controllo SelectionTree pubblica automaticamente gli eventi di controllo seguenti in Windows XP o nei sistemi operativi precedenti. Il controllo SelectionTree pubblica questi eventi quando l'elemento selezionato viene modificato da un nodo a un altro. Se l'albero di selezione non contiene nodi, il controllo pubblica questi eventi e cancella il contenuto dei controlli che sottoscrivono l'evento. Questi eventi ControlEvent non devono essere elencati nella tabella ControlEvent.
| Evento di controllo | Descrizione |
|---|---|
| SelectionAction | Pubblica una stringa dalla tabella UIText che descrive l'elemento evidenziato. |
| SelectionBrowse | Genera una finestra di dialogo Sfoglia utilizzata per modificare il percorso dell'elemento evidenziato. |
| SelectionDescription | Pubblica una stringa dalla tabella Feature che descrive l'elemento evidenziato. |
| SelectionNoItems | Elimina il testo descrittivo o disabilita i pulsanti di un elemento obsoleto. |
| SelectionPath | Pubblica il percorso per l'elemento evidenziato. |
| SelectionPathOn | Pubblica se è presente o meno un percorso di selezione associato alla funzionalità attualmente selezionata. |
| SelectionSize | Pubblica le dimensioni dell'elemento evidenziato. |
A partire dai sistemi Windows Server 2003, i controlli SelectionTree pubblicano tutti gli eventi nella tabella precedente e, inoltre, pubblicano un Controllo DoActionEvent o Un Oggetto ControlEvent SetProperty. I record devono essere aggiunti alla tabella ControlEvent per pubblicare DoAction o SetProperty ControlEvents.
| Evento di controllo | Descrizione |
|---|---|
| DoAction | Notifica al programma di installazione di eseguire un'azione personalizzata. |
| SetProperty | Imposta una proprietà su un nuovo valore. |
A partire da Windows Installer versione 3.0, i controlli SelectionTree pubblicano un evento che esegue azioni personalizzate elencate nella tabella ControlEvent. Il controllo SelectionTree pubblica questo evento ogni volta che la selezione delle funzionalità cambia nel controllo o ogni volta che viene scelto uno stato di selezione diverso per la funzionalità corrente. Le azioni personalizzate vengono eseguite ogni volta che viene pubblicato l'evento. Il controllo SelectionTree invia informazioni all'azione personalizzata impostando i valori delle proprietà seguenti. Tutte queste proprietà vengono cancellate quando il controllo SelectionTree viene chiuso.
Windows Installer 2.0: non supportato. Il controllo SelectionTree non pubblica l'evento e non imposta le proprietà seguenti.
| Proprietà | Descrizione |
|---|---|
| MsiSelectionTreeSelectedFeature | Nome della funzionalità selezionata nel campo Funzionalità della tabella Funzionalità. |
| MsiSelectionTreeSelectedAction | Stato dell'azione di installazione della funzionalità selezionata. Il valore può essere INSTALLSTATE_ABedizione Standard NT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE o INSTALLSTATE_ADVERTIedizione Standard D. |
| MsiSelectonTreeChildrenCount | Numero di nodi figlio diretti. |
| MsiSelectionTreeInstallingChildrenCount | Numero di nodi figlio diretti INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE o INSTALLSTATE_ADVERTIedizione Standard D. |
| MsiSelectionTreeSelectedCost | Costo dell'installazione della funzionalità selezionata in unità di 512 byte. |
| MsiSelectionTreeChildrenCost | Costo dell'installazione di tutte le funzionalità figlio in unità di 512 byte. |
| MsiSelectionTreeSelectedPath | Percorso in cui viene installata la funzionalità selezionata. Definito solo se la funzionalità viene installata come INSTALLSTATE_LOCAL. |
Nota
Il contenuto del campo Testo della tabella Control non viene mai visualizzato dal controllo SelectionTree. Questo campo specifica invece lo stile del testo da visualizzare dal controllo e contiene una descrizione del controllo utilizzato dalle utilità di revisione dello schermo. 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 TextStyle 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. Le informazioni seguenti sono lette dalle utilità di revisione dello schermo come descrizione del controllo. Vedere Accessibilità.
Attributi di controllo
È possibile usare gli attributi seguenti con questo controllo. Per modificare il valore di un attributo usando un evento, sottoscrivere il controllo a un Oggetto ControlEvent nella tabella EventMapping ed elencare l'identificatore dell'attributo nella colonna Attribute. Immettere l'identificatore dell'evento ControlEvent nella colonna Evento.
| Identificatore dell'attributo | Bit esadecimale | Descrizione |
|---|---|---|
| IndirectPropertyName | 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 corrisponde anche al valore della proprietà elencata nella colonna Proprietà della tabella Control. | |
| 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 Control. Usare le unità di installazione per lunghezza e distanza. |
|
| PropertyName | 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 Property della tabella Control. | |
| 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 | Visualizza il testo nei visualizzatori di schermo in base al testo immesso nella colonna Testo della tabella Control. Vedere Accessibilità. | |
| Visible | 0x00000000 0x00000001 |
Controllo nascosto. Controllo visibile. Includere questo bit nella parola bit della colonna Attributes della tabella Control per rendere visibile o nascosto il controllo al momento della creazione. È anche possibile nascondere o visualizzare un controllo tramite 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 del controllo per abilitare il controllo alla creazione. È anche possibile abilitare o disabilitare un controllo tramite la tabella ControlCondition. |
| Affondata | 0x00000000 0x00000004 |
Visualizza lo stile di visualizzazione predefinito. Visualizza il controllo con un aspetto incassato, 3D. Includere questi bit nella parola bit nella colonna Attributi della tabella Control. |
| Indiretto | 0x00000000 0x00000008 |
Il controllo visualizza o modifica il valore della proprietà nella colonna Proprietà della tabella Control. Il controllo visualizza o modifica il valore della proprietà con l'identificatore elencato nella colonna Proprietà della tabella Control. Determina se alla proprietà associata a questo controllo viene fatto riferimento indirettamente. |
| RTLRO | 0x00000000 0x00000020 |
Il testo nel controllo viene visualizzato in ordine di lettura da sinistra a destra. Il testo nel controllo viene visualizzato in ordine di lettura da destra a sinistra. |
| RightAligned | 0x00000000 0x00000040 |
Il testo nel controllo è allineato a sinistra. Il testo nel controllo è allineato a destra. |
| LeftScroll | 0x00000000 0x00000080 |
La barra di scorrimento si trova sul lato destro del controllo. La barra di scorrimento si trova sul lato sinistro del controllo. |
| Bidi | 0x000000E0 | Impostare questo valore per una combinazione degli attributi RTLRO, RightAligned e LeftScroll . |
Osservazioni:
Questo controllo può essere creato dalla classe WC_TRedizione Enterprise VIEW usando la funzione CreateWindowEx. Include gli stili WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWedizione Standard LALWAYS, WS_CHILD, WS_TABSTOP e WS_GROUP.
L'albero di selezione viene popolato solo se è stata chiamata l'azione CostInitialize e CostFinalize.
La stringa seguente nella tabella UIText è correlata a questo controllo.
| Termine | Descrizione |
|---|---|
| AbsentPath |
Percorso visualizzato per un elemento nello stato assente. |
Le sei stringhe seguenti vengono usate per visualizzare il numero di elementi figlio selezionati e le dimensioni associate all'elemento evidenziato:
- SelChildCostPos
- SelChildCostNeg
- SelParentCostPos
- SelParentCostPosNeg
- SelParentCostNegPos
- SelParentCostNegNeg
Le stringhe seguenti vengono usate per visualizzare le opzioni di selezione disponibili per un elemento in un menu popup:
- MenuAbsent
- MenuLocal
- MenuCD
- MenuRete
- MenuAllLocal
- MenuAllCD
- MenuAllNetwork
Le stringhe seguenti vengono usate per spiegare la selezione presente nell'evento SelectionDescription ControlEvent.
- SelAbsentAbsent
- SelAbsentLocal
- SelAbsentCD
- SelAbsentNetwork
- SelLocalAbsent
- SelLocalLocal
- SelLocalCD
- SelLocalNetwork
- SelCDAbsent
- SelNetworkAbsent
- SelCDLocal
- SelNetworkLocal
- SelCDCD
- SelNetworkNetwork
Nella formattazione delle dimensioni di un file vengono usate le quattro stringhe localizzate seguenti:
- Byte
- KB
- MB
- GB