DrawListViewSubItemEventArgs.DrawDefault Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob das ListViewItem.ListViewSubItem vom Betriebssystem (und nicht vom Benutzer) gezeichnet werden soll, oder legt diesen fest.
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
Eigenschaftswert
true
, wenn das Unterelement vom Betriebssystem gezeichnet werden soll, andernfalls false
. Der Standardwert ist false
.
Beispiele
Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses ListView.DrawSubItem . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Ihnen beim Debuggen helfen.
Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance vom Typ ListView enthältListView1
. Stellen Sie dann sicher, dass der Ereignishandler dem ListView.DrawSubItem Ereignis zugeordnet ist.
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
Hinweise
Verwenden Sie diese Eigenschaft, wenn Sie das ListView.DrawSubItem Ereignis für Unterelemente behandeln, die Sie nicht anpassen möchten. Wenn Sie diese Eigenschaft auf true
festlegen, wird das Unterelement normal mit den aktuellen Werten der ListViewItem.ListViewSubItem.BackColorEigenschaften , ListViewItem.ListViewSubItem.ForeColorund ListViewItem.ListViewSubItem.Font gezeichnet.
Hinweis
Die UseItemStyleForSubItems -Eigenschaft des übergeordneten ListViewItem Elements muss auf false
festgelegt werden, um zu verhindern, dass der ListViewItem.BackColor Wert des übergeordneten Elements den Unterelementwert überschreibt.