DynamicRenderer.Refresh-Methode

Artikel
10/28/2008

Bewirkt, dass das DynamicRenderer-Objekt die Freihanddaten, die sich gerade in seinem Datenspeicher befinden, neu zeichnet.

Namespace: Microsoft.StylusInput
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub Refresh
'Usage
Dim instance As DynamicRenderer

instance.Refresh()

public void Refresh()

public:
void Refresh()

public void Refresh()

public function Refresh()

Hinweise

Wenn die EnableDataCache-Eigenschaft true ist, zeichnet das DynamicRenderer-Objekt alle noch nicht aus dem Cache freigegebenen Tablettstiftdaten neu. Wenn die EnableDataCache-Eigenschaft false ist, zeichnet das DynamicRenderer-Objekt lediglich den aktuellen Strich neu.

Wenn Sie die Refresh-Methode des DynamicRenderer-Objekts aus einem Paint-Ereignishandler aufrufen, legen Sie die ClipRectangle-Eigenschaft des DynamicRenderer-Objekts auf die ClipRectangle-Eigenschaft des PaintEventArgs-Objekts fest.

Diese Methode löst eine Ausnahme aus, wenn das DynamicRenderer-Objekt bereits freigegeben wurde.

Beispiele

In diesem C#-Beispiel ruft die Refresh-Methode eines DynamicRenderer-Objekts theDynamicRenderer aus dem Paint-Ereignis eines Control auf. Wenn das Fenster ungültig wird, zeichnet der DynamicRenderer alle Tablettstiftdaten in seinem Datencache neu. Weitere Informationen über die Auswirkungen der EnableDataCache-Eigenschaft auf diesen Vorgang finden Sie im Abschnitt Hinweise dieses Themas.

private void InkCollection_Paint(object sender, System.Windows.Forms.PaintEventArgs e)
{
    // Refresh the dynamic renderer, since it's possible that a stroke is being
    // collected at the time Paint occurs.  In this case, the portion of the stroke
    // that has already been collected will need to be redrawn.
    theDynamicRenderer.ClipRectangle = e.ClipRectangle;
    theDynamicRenderer.Refresh();

    // ...
}

In diesem Microsoft Visual Basic .NET-Beispiel wird die Refresh-Methode eines DynamicRenderer-Objekts theDynamicRenderer aus dem Paint-Ereignis von Control aufgerufen. Wenn das Fenster ungültig wird, zeichnet der DynamicRenderer alle Tablettstiftdaten in seinem Datencache neu. Weitere Informationen über die Auswirkungen der EnableDataCache-Eigenschaft auf diesen Vorgang finden Sie im Abschnitt Hinweise dieses Themas.

Private Sub InkCollector_Paint(ByVal sender As Object, ByVal e As System.Windows.Forms.PaintEventArgs) _
Handles MyBase.Paint
    ' Refresh the dynamic renderer, since it's possible that a stroke is being
    ' collected at the time Paint occurs.  In this case, the portion of the stroke
    ' that has already been collected will need to be redrawn.
    theDynamicRenderer.ClipRectangle = e.ClipRectangle
    theDynamicRenderer.Refresh()

    ' ...
End Sub

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.