DrawListViewSubItemEventArgs.DrawDefault Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si ListViewItem.ListViewSubItem doit être dessiné par le système d'exploitation plutôt qu'être owner-drawn.
public:
property bool DrawDefault { bool get(); void set(bool value); };
public bool DrawDefault { get; set; }
member this.DrawDefault : bool with get, set
Public Property DrawDefault As Boolean
Valeur de propriété
true
si le sous-élément doit être dessiné par le système d'exploitation ; sinon, false
. La valeur par défaut est false
.
Exemples
L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement ListView.DrawSubItem . Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à déboguer.
Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance de type ListView nommé ListView1
. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement ListView.DrawSubItem .
private void ListView1_DrawSubItem(Object sender, DrawListViewSubItemEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "DrawDefault", e.DrawDefault );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Graphics", e.Graphics );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Bounds", e.Bounds );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Item", e.Item );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "SubItem", e.SubItem );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ItemIndex", e.ItemIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ColumnIndex", e.ColumnIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Header", e.Header );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ItemState", e.ItemState );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "DrawSubItem Event" );
}
Private Sub ListView1_DrawSubItem(sender as Object, e as DrawListViewSubItemEventArgs) _
Handles ListView1.DrawSubItem
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "DrawDefault", e.DrawDefault)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Graphics", e.Graphics)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Bounds", e.Bounds)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Item", e.Item)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "SubItem", e.SubItem)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "ItemIndex", e.ItemIndex)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "ColumnIndex", e.ColumnIndex)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Header", e.Header)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "ItemState", e.ItemState)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"DrawSubItem Event")
End Sub
Remarques
Utilisez cette propriété lors de la gestion de l’événement ListView.DrawSubItem pour les sous-éléments que vous ne souhaitez pas personnaliser. Si vous définissez cette propriété sur true
, le sous-élément est dessiné normalement à l’aide des valeurs actuelles des ListViewItem.ListViewSubItem.BackColorpropriétés , ListViewItem.ListViewSubItem.ForeColoret ListViewItem.ListViewSubItem.Font
Notes
La UseItemStyleForSubItems propriété du parent ListViewItem doit être définie sur false
pour empêcher la ListViewItem.BackColor valeur de l’élément parent de remplacer la valeur du sous-élément.