DataRepeater.DrawItem-Ereignis

  • Artikel

Tritt ein, wenn DataRepeaterItem gezeichnet werden muss.

Namespace:  Microsoft.VisualBasic.PowerPacks
Assembly:  Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
Public Event DrawItem As DataRepeaterItemEventHandler

public event DataRepeaterItemEventHandler DrawItem

public:
 event DataRepeaterItemEventHandler^ DrawItem {
    void add (DataRepeaterItemEventHandler^ value);
    void remove (DataRepeaterItemEventHandler^ value);
}

member DrawItem : IEvent<DataRepeaterItemEventHandler,
    DataRepeaterItemEventArgs>

JScript unterstützt keine Ereignisse.

Hinweise

Verwenden Sie dieses Ereignis, um die Darstellung der DataRepeaterItem-Objekten zu ändern, wie sie in der Ansicht einen Bildlauf durchgeführt werden.

Zur Laufzeit können darstellungsbezogene Eigenschaften auf Grundlage von Bedingungen festgelegt werden, während jedes Element in der Ansicht einen Bildlauf durchgeführt wird.In einer Planungsanwendung können Sie z. B. die Hintergrundfarbe eines Elements ändern, um Benutzer darauf aufmerksam zu machen, dass der Fälligkeitstermin des Elements verstrichen ist.Beim Festlegen einer Eigenschaft in einer Bedingungsanweisung wie If…Theneine Else-Klausel auch verwenden, um das Erscheinungsbild anzugeben, wenn die Bedingung nicht erfüllt wird.

Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.

Beispiele

Zu den häufigsten Anpassungen für das DataRepeater-Steuerelement gehören die Anzeige der Zeilen in unterschiedlichen Farben und die Änderung der Farbe eines Felds auf Basis einer Bedingung.Das folgende Beispiel veranschaulicht, wie diese Anpassungen vorgenommen werden.In diesem Beispiel wird davon ausgegangen, dass Sie über ein DataRepeater-Steuerelement verfügen, das an die Products-Tabelle in der Datenbank Northwind gebunden ist.

Private Sub DataRepeater1_DrawItem(
    ByVal sender As Object, 
    ByVal e As Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs
  ) Handles DataRepeater1.DrawItem

    ' Alternate the back color.
    If (e.DataRepeaterItem.ItemIndex Mod 2) <> 0 Then
        ' Apply the secondary back color.
        e.DataRepeaterItem.BackColor = Color.AliceBlue
    Else
        ' Apply the default back color.
        e.DataRepeaterItem.BackColor = Color.White
    End If
    ' Change the color of out-of-stock items to red.
    If e.DataRepeaterItem.Controls(
          UnitsInStockTextBox.Name).Text < 1 Then

        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). 
         BackColor = Color.Red
    Else
        e.DataRepeaterItem.Controls(UnitsInStockTextBox.Name). 
         BackColor = Color.White
    End If
End Sub

private void dataRepeater1_DrawItem(object sender, 
    Microsoft.VisualBasic.PowerPacks.DataRepeaterItemEventArgs e)
{
    // Alternate the back color.
    if ((e.DataRepeaterItem.ItemIndex % 2) != 0)
    // Apply the secondary back color.
    {
        e.DataRepeaterItem.BackColor = Color.AliceBlue;
    }
    else
    {
        // Apply the default back color.
        e.DataRepeaterItem.BackColor = Color.White;
    }
    // Change the color of out-of-stock items to red.
    if (e.DataRepeaterItem.Controls["unitsInStockTextBox"].Text == "0")
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.Red;
    }
    else
    {
        e.DataRepeaterItem.Controls["unitsInStockTextBox"].BackColor = Color.White;
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

DataRepeater Klasse

Microsoft.VisualBasic.PowerPacks-Namespace

Weitere Ressourcen

Einführung in das DataRepeater-Steuerelement (Visual Studio)

Gewusst wie: Ändern der Darstellung eines DataRepeater-Steuerelements (Visual Studio)