DataRepeater.DrawItem-Ereignis

Artikel
05/16/2015

Tritt ein, wenn eine 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 das Erscheinungsbild des DataRepeaterItem Objekte, wie sie bei einem Bildlauf sichtbar sind.

Zur Laufzeit können Darstellungseigenschaften basierend auf Bedingungen festgelegt werden, wie jedes Element ein Bildlauf durchgeführt wird. In einer Planungsanwendung können Sie z. B. die Hintergrundfarbe eines Elements, um Benutzer zu warnen, wenn ein Element überfällig ist ändern. Wenn Sie eine Eigenschaft wie z. B. in einer bedingten Anweisung festlegen If…Then, müssen Sie auch verwenden ein Else -Klausel, um die Darstellung zu geben, wenn die Bedingung nicht erfüllt ist.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.

Beispiele

Einige allgemeinen Anpassungen für die DataRepeater -Steuerelement gehören die Anzeige der Zeilen in unterschiedlichen Farben und das Ändern der Farbe eines Felds auf Grundlage einer Bedingung. Im folgenden Beispiel wird veranschaulicht, wie diese Anpassungen vorgenommen. In diesem Beispiel wird vorausgesetzt, dass Sie ein DataRepeater -Steuerelement, das an die Products-Tabelle in der Northwind-Datenbank 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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.