Il presente articolo è stato tradotto manualmente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Classe DataGridViewCellStyle

Rappresenta le informazioni relative alla formattazione e allo stile applicate a singole celle all'interno di un controllo DataGridView.

System.Object
  System.Windows.Forms.DataGridViewCellStyle

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
[TypeConverterAttribute(typeof(DataGridViewCellStyleConverter))]
public class DataGridViewCellStyle : ICloneable

Il tipo DataGridViewCellStyle espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoDataGridViewCellStyle()Inizializza una nuova istanza della classe DataGridViewCellStyle utilizzando i valori predefiniti delle proprietà.
Metodo pubblicoDataGridViewCellStyle(DataGridViewCellStyle)Inizializza una nuova istanza della classe DataGridViewCellStyle utilizzando i valori delle proprietà dell'oggetto DataGridViewCellStyle specificato.
In alto
  NomeDescrizione
Proprietà pubblicaAlignmentOttiene o imposta un valore che indica la posizione del contenuto in una cella di DataGridView.
Proprietà pubblicaBackColorOttiene o imposta il colore di sfondo di una cella di DataGridView.
Proprietà pubblicaDataSourceNullValueOttiene o imposta il valore salvato nell'origine dati quando l'utente immette un valore null in una cella.
Proprietà pubblicaFontOttiene o imposta il carattere applicato al contenuto testuale di una cella di DataGridView.
Proprietà pubblicaForeColorOttiene o imposta il colore di primo piano di una cella di DataGridView.
Proprietà pubblicaFormatOttiene o imposta la stringa di formato applicata al contenuto testuale di una cella di DataGridView.
Proprietà pubblicaFormatProviderOttiene o imposta l'oggetto utilizzato per fornire una formattazione specifica delle impostazioni cultura per i valori delle celle di DataGridView.
Proprietà pubblicaIsDataSourceNullValueDefaultOttiene un valore che indica se la proprietà DataSourceNullValue è stata impostata.
Proprietà pubblicaIsFormatProviderDefaultOttiene un valore che indica se la proprietà FormatProvider è stata impostata.
Proprietà pubblicaIsNullValueDefaultOttiene un valore che indica se la proprietà NullValue è stata impostata.
Proprietà pubblicaNullValueOttiene o imposta il valore di visualizzazione delle celle di DataGridView corrispondente al valore DBNull.Value o null.
Proprietà pubblicaPaddingOttiene o imposta lo spazio tra il bordo di un oggetto DataGridViewCell e il relativo contenuto.
Proprietà pubblicaSelectionBackColorOttiene o imposta il colore di sfondo utilizzato da una cella di DataGridView quando viene selezionata.
Proprietà pubblicaSelectionForeColorOttiene o imposta il colore di primo piano utilizzato da una cella di DataGridView quando viene selezionata.
Proprietà pubblicaTagOttiene o imposta un oggetto contenente dati aggiuntivi relativi a DataGridViewCellStyle.
Proprietà pubblicaWrapModeOttiene o imposta un valore che indica se il contenuto testuale in una cella di DataGridView deve continuare nelle righe successive o deve essere troncato quando è troppo lungo per essere contenuto in una singola riga.
In alto
  NomeDescrizione
Metodo pubblicoApplyStyleApplica l'oggetto DataGridViewCellStyle specificato all'oggetto DataGridViewCellStyle corrente.
Metodo pubblicoCloneCrea una copia esatta di questo DataGridViewCellStyle.
Metodo pubblicoEqualsRestituisce un valore che indica se l'istanza è equivalente all'oggetto specificato. (Esegue l'override di Object.Equals(Object)).
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoGetHashCodeFunge da funzione hash per un determinato tipo. (Esegue l'override di Object.GetHashCode()).
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo protettoMemberwiseCloneConsente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblicoToStringRestituisce una stringa che indica le impostazioni correnti delle proprietà di DataGridViewCellStyle. (Esegue l'override di Object.ToString()).
In alto
  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoICloneable.CloneCrea una copia esatta di questo DataGridViewCellStyle.
In alto

La classe DataGridViewCellStyle consente di condividere le informazioni relative allo stile tra più celle, righe, colonne e intestazioni di riga o colonna di DataGridView, in modo da evitare i requisiti di memoria relativi all'impostazione delle proprietà di stile su singole celle. Per ulteriori informazioni sulle classi che dispongono di una proprietà di tipo DataGridViewCellStyle e su come sono correlate, vedere Stili della cella nel controllo DataGridView Windows Form.

Nell'esempio di codice riportato di seguito viene illustrato l'effetto dell'impostazione delle proprietà su più oggetti DataGridViewCellStyle. Nell'esempio viene impostato il colore di sfondo delle celle in DataGridView mediante l'impostazione della proprietà BackColor sul valore della proprietà DefaultCellStyle. Il colore di sfondo viene sottoposto a override su righe alterne poiché la proprietà BackColor è impostata sul valore della proprietà AlternatingRowsDefaultCellStyle. Nell'esempio viene inoltre determinato il formato delle date nella colonna denominata Last Prepared mediante l'impostazione della proprietà Format sul valore della proprietà DefaultCellStyle della colonna.


using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    [STAThreadAttribute()]
    public static void Main()
    {
        Application.Run(new Form1());
    }

    private DataGridView dataGridView1 = new DataGridView();

    protected override void OnLoad(EventArgs e)
    {
        // Create the columns and load the data.
        PopulateDataGridView();

        // Configure the appearance and behavior of the DataGridView.
        InitializeDataGridView();

        // Initialize the form.
        this.Text = "DataGridView style demo";
        this.Size = new Size(600, 250);
        this.Controls.Add(dataGridView1);
        base.OnLoad(e);
    }

    // Configures the appearance and behavior of a DataGridView control.
    private void InitializeDataGridView()
    {
        // Initialize basic DataGridView properties.
        dataGridView1.Dock = DockStyle.Fill;
        dataGridView1.BackgroundColor = Color.LightGray;
        dataGridView1.BorderStyle = BorderStyle.Fixed3D;

        // Set property values appropriate for read-only display and 
        // limited interactivity. 
        dataGridView1.AllowUserToAddRows = false;
        dataGridView1.AllowUserToDeleteRows = false;
        dataGridView1.AllowUserToOrderColumns = true;
        dataGridView1.ReadOnly = true;
        dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
        dataGridView1.MultiSelect = false;
        dataGridView1.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.None;
        dataGridView1.AllowUserToResizeColumns = false;
        dataGridView1.ColumnHeadersHeightSizeMode = 
            DataGridViewColumnHeadersHeightSizeMode.DisableResizing;
        dataGridView1.AllowUserToResizeRows = false;
        dataGridView1.RowHeadersWidthSizeMode = 
            DataGridViewRowHeadersWidthSizeMode.DisableResizing;

        // Set the selection background color for all the cells.
        dataGridView1.DefaultCellStyle.SelectionBackColor = Color.White;
        dataGridView1.DefaultCellStyle.SelectionForeColor = Color.Black;

        // Set RowHeadersDefaultCellStyle.SelectionBackColor so that its default
        // value won't override DataGridView.DefaultCellStyle.SelectionBackColor.
        dataGridView1.RowHeadersDefaultCellStyle.SelectionBackColor = Color.Empty;

        // Set the background color for all rows and for alternating rows. 
        // The value for alternating rows overrides the value for all rows. 
        dataGridView1.RowsDefaultCellStyle.BackColor = Color.LightGray;
        dataGridView1.AlternatingRowsDefaultCellStyle.BackColor = Color.DarkGray;

        // Set the row and column header styles.
        dataGridView1.ColumnHeadersDefaultCellStyle.ForeColor = Color.White;
        dataGridView1.ColumnHeadersDefaultCellStyle.BackColor = Color.Black;
        dataGridView1.RowHeadersDefaultCellStyle.BackColor = Color.Black;

        // Set the Format property on the "Last Prepared" column to cause
        // the DateTime to be formatted as "Month, Year".
        dataGridView1.Columns["Last Prepared"].DefaultCellStyle.Format = "y";

        // Specify a larger font for the "Ratings" column. 
        using (Font font = new Font(
            dataGridView1.DefaultCellStyle.Font.FontFamily, 25, FontStyle.Bold))
        {
            dataGridView1.Columns["Rating"].DefaultCellStyle.Font = font;
        }

        // Attach a handler to the CellFormatting event.
        dataGridView1.CellFormatting += new
            DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
    }

    // Changes the foreground color of cells in the "Ratings" column 
    // depending on the number of stars. 
    private void dataGridView1_CellFormatting(object sender,
        DataGridViewCellFormattingEventArgs e)
    {
        if (e.ColumnIndex == dataGridView1.Columns["Rating"].Index
            && e.Value != null)
        {
            switch (e.Value.ToString().Length)
            {
                case 1:
                    e.CellStyle.SelectionForeColor = Color.Red;
                    e.CellStyle.ForeColor = Color.Red;
                    break;
                case 2:
                    e.CellStyle.SelectionForeColor = Color.Yellow;
                    e.CellStyle.ForeColor = Color.Yellow;
                    break;
                case 3:
                    e.CellStyle.SelectionForeColor = Color.Green;
                    e.CellStyle.ForeColor = Color.Green;
                    break;
                case 4:
                    e.CellStyle.SelectionForeColor = Color.Blue;
                    e.CellStyle.ForeColor = Color.Blue;
                    break;
            }
        }
    }

    // Creates the columns and loads the data.
    private void PopulateDataGridView()
    {
        // Set the column header names.
        dataGridView1.ColumnCount = 5;
        dataGridView1.Columns[0].Name = "Recipe";
        dataGridView1.Columns[1].Name = "Category";
        dataGridView1.Columns[2].Name = "Main Ingredients";
        dataGridView1.Columns[3].Name = "Last Prepared";
        dataGridView1.Columns[4].Name = "Rating";

        // Populate the rows.
        object[] row1 = new object[]{"Meatloaf", "Main Dish", 
            "ground beef", new DateTime(2000, 3, 23), "*"};
        object[] row2 = new object[]{"Key Lime Pie", "Dessert", 
            "lime juice, evaporated milk", new DateTime(2002, 4, 12), "****"};
        object[] row3 = new object[]{"Orange-Salsa Pork Chops", "Main Dish", 
            "pork chops, salsa, orange juice", new DateTime(2000, 8, 9), "****"};
        object[] row4 = new object[]{"Black Bean and Rice Salad", "Salad", 
            "black beans, brown rice", new DateTime(1999, 5, 7), "****"};
        object[] row5 = new object[]{"Chocolate Cheesecake", "Dessert", 
            "cream cheese", new DateTime(2003, 3, 12), "***"};
        object[] row6 = new object[]{"Black Bean Dip", "Appetizer",
            "black beans, sour cream", new DateTime(2003, 12, 23), "***"};

        // Add the rows to the DataGridView.
        object[] rows = new object[] { row1, row2, row3, row4, row5, row6 };
        foreach (object[] rowArray in rows)
        {
            dataGridView1.Rows.Add(rowArray);
        }

        // Adjust the row heights so that all content is visible.
        dataGridView1.AutoResizeRows(
            DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
    }

}


.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Il documento è risultato utile?
(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI
© 2013 Microsoft. Tutti i diritti riservati.