Pagine delle proprietà (C++)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Le pagine delle proprietà sono elementi dell'interfaccia utente di Visual Studio che consentono di specificare e applicare impostazioni ai progetti.

Per accedere alle pagine delle proprietà selezionare un progetto e scegliere Proprietà dal menu di scelta rapida oppure scegliere Proprietà dal menu Progetto. Quando si specificano valori nella finestra di dialogo delle pagine delle proprietà, questi vengono applicati ai progetti selezionati in Esplora soluzioni.

Le impostazioni di progetto possono essere specificate e applicate a tutte le configurazioni della build oppure si possono specificare proprietà di progetto separate per ogni configurazione della build esistente. È ad esempio possibile specificare impostazioni relative alla configurazione di rilascio che non si applicano alla configurazione di debug.

Le pagine delle proprietà sono dinamiche e quelle che vengono visualizzate dipendono dai tipi di file nel progetto. Se, ad esempio, non si dispone di un file IDL nel progetto, la pagina delle proprietà IDL non verrà visualizzata nella finestra di dialogo Pagine delle proprietà.

Per ulteriori informazioni, vedere Procedura: specificare le proprietà del progetto tramite le pagine delle proprietà.

Proprietà predefinite e modificate

I valori delle proprietà visualizzati in grassetto sono i valori che sono cambiati. L'impostazione predefinita di una proprietà a livello del progetto, ovvero quando il nodo progetto è selezionato in Esplora soluzioni, è in genere il valore predefinito di tale proprietà per lo strumento. In un progetto Win32, ad esempio, per impostazione predefinita la proprietà Attiva condivisione stringhe è inizialmente impostata su No nella pagina delle proprietà Generazione codice del compilatore e non è visualizzata in grassetto. Tale valore infatti corrisponde all'impostazione predefinita del progetto. Se si utilizza CL.exe dalla riga di comando, l'opzione /GF non è attiva a meno che non venga specificata.

Se una proprietà viene modificata dall'utente o dalla procedura guidata, il valore viene visualizzato in grassetto. Nella stessa pagina delle proprietà Generazione codice, ad esempio, /RTC1 è attivo per la proprietà Controlli runtime di base. Alla riga di comando /RTC1 non è attivo per impostazione predefinita. In questo caso, l'impostazione predefinita del progetto per la proprietà è stata modificata dalla creazione guidata applicazione.

Viene visualizzato un sottoinsieme delle impostazioni predefinite del progetto, le quali sono modificabili. Per ulteriori informazioni, vedere la sezione sulle impostazioni predefinite di progetto in Pagina delle proprietà Generale (Progetto)

Reimpostazione delle proprietà

Quando si visualizza la finestra di dialogo Pagine delle proprietà di un progetto e si seleziona il nodo del progetto in Esplora soluzioni, è possibile selezionare <eredita da impostazioni predefinite progetto> per ciascuna proprietà.

Scegliere Applica per fare in modo che la finestra di dialogo Pagine delle proprietà venga aggiornata con le ultime selezioni effettuate quando si ripristina l'impostazione predefinita del progetto per una proprietà.

Quando si visualizza la finestra di dialogo Pagine delle proprietà di un progetto e si seleziona un file in Esplora soluzioni, se il valore di una proprietà viene visualizzato in grassetto significa che tale valore è stato modificato a livello di file. Di conseguenza, è possibile selezionare <eredita da progetto> per ciascuna proprietà. Se molti file contengono proprietà modificate, per la generazione del progetto sarà necessario più tempo.

Le impostazioni predefinite del progetto sono principalmente quelle del sistema (piattaforma). Alcune impostazioni predefinite del progetto derivano dai fogli di stile applicati quando si aggiornano le proprietà nella sezione Impostazioni predefinite progetto della pagina di configurazione del progetto generale (vedere Pagina delle proprietà Generale (Progetto)).

Immissione dei valori definiti dall'utente

Per alcune proprietà è necessario specificare i valori. Per alcune di queste proprietà è possibile utilizzare uno o più valori (proprietà a valore multiplo), mentre con altre è possibile utilizzare un solo valore (proprietà a valore unico).

È possibile immettere il testo direttamente nella colonna destra della pagina delle proprietà, separando i valori con un punto e virgola e utilizzando solo caratteri alfanumerici. Su questi valori non viene eseguito il controllo degli errori.

È anche possibile selezionare <Modifica...> dall'elenco a discesa (per le proprietà singole) o scegliere il pulsante Sfoglia (per una proprietà a valore multiplo selezionata). Verrà visualizzata una finestra di dialogo in cui è immettere uno o più valori per la proprietà. Il titolo della finestra di dialogo corrisponde al nome della proprietà di cui si stanno modificando i valori. Per le proprietà a valore multiplo immettere un valore per riga inserendo un carattere di ritorno a capo dopo ogni valore.

Le caselle di testo delle proprietà a valore multiplo dispongono di una casella di controllo eredita da progetto (a livello di file) o eredita da impostazioni predefinite progetto (a livello di progetto) Per impostazione predefinita, la casella di controllo è selezionata. La proprietà quindi può ereditare valori dal progetto, se si seleziona un file, o dalle impostazioni predefinite del progetto, se quest'ultimo è selezionato in Esplora soluzioni.

I valori visualizzati per una proprietà a valore multiplo nella finestra di dialogo delle pagine della proprietà indicano solo le impostazioni della proprietà relative al livello corrente. Se ad esempio un file è selezionato in Esplora soluzioni e si seleziona la proprietà C/C++ Definizioni preprocessore, le definizioni di preprocessore relative al livello di progetto non verranno visualizzate nella pagina delle proprietà. Nella casella di testo della proprietà a valore multiplo tuttavia, sono visualizzati tutti i valori ereditati relativi alla proprietà.

Se si utilizza il Modello progetto di Visual C++ anche gli oggetti su file e progetti hanno lo stesso comportamento. Eseguendo la query dei valori su una proprietà a livello di file non si otterranno i valori della proprietà a livello di progetto; è necessario richiedere i valori della proprietà a livello di progetto in modo esplicito. È inoltre possibile che alcuni valori ereditati di una proprietà derivino da un foglio di stile, a cui non è possibile accedere a livello di codice in questa versione.

Macro $(Inherit) e $(NoInherit)

Per le proprietà in cui si specificano valori definiti dall'utente è possibile utilizzare due macro:

$(Inherit)
$(NoInherit)

Deselezionare la casella di controllo (ad esempio eredita da impostazioni predefinite progetto) equivale a specificare $(NoInherit), ma è un'operazione più semplice. Se si specifica $(NoInherit), è sempre possibile specificare i valori personalizzati.

L'impostazione della casella di controllo eredita da progetto o eredita da impostazioni predefinite progetto viene ignorata se si utilizza una di queste macro nella casella di testo.

Se si utilizza $(NoInherit) su una proprietà, è necessario verificare se una delle impostazioni predefinite del progetto influisce su tale proprietà. In tal caso, si potrebbe erroneamente verificare la sostituzione di un'impostazione predefinita specificata per il progetto.