IDynamicRenderer::get_DataCacheEnabled-Methode (rtscom.h)

Ruft einen Wert ab, der angibt, ob die Datenzwischenspeicherung für das DynamicRenderer Class-Objekt aktiviert ist, oder legt diesen fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_DataCacheEnabled(
  BOOL *pfCacheData
);

Parameter

pfCacheData

Rückgabewert

Keine

Bemerkungen

Wenn Sie die DataCacheEnabled-Eigenschaft auf TRUE festlegen, können Sie die Situation verwalten, in der langsame Prozesse die Ausgabewarteschlange blockieren. Wenn das Fenster ungültig wird, nachdem Striche vom DynamicRenderer-Klassenobjekt gezeichnet wurden, kann es zu einer Verzögerung kommen, bevor die gesammelten Striche gezeichnet werden. Platzieren Sie die Striche des dynamischen Renderers in einem Cache, und verwenden Sie die IDynamicRenderer::Refresh-Methode , um die Striche neu zu zeichnen.

Nachdem die Striche gesammelt wurden, müssen Sie sie aus dem Cache freigeben, indem Sie die IDynamicRenderer::ReleaseCachedData-Methode aufrufen. Verwenden Sie die IStylusPlugin::CustomStylusDataAdded-Methode , um die Striche freizugeben.

Es ist auch hilfreich, die DataCacheEnabled-Eigenschaft auf TRUE festzulegen, wenn Sie Striche beim Zeichnen anzeigen möchten, die Striche jedoch nicht speichern müssen, nachdem Sie etwas mit ihnen ausgeführt haben. Speichern Sie in diesem Fall die Datenbezeichner im data-Parameter der IStylusPlugin::CustomStylusDataAdded Method-Methode , und geben Sie dann die Daten frei, wenn Sie die zwischengespeicherten Striche nicht mehr benötigen.

Wenn diese Eigenschaft TRUE ist, müssen Sie die IDynamicRenderer::ReleaseCachedData-Methode für Striche aufrufen, die im Freihandsammlungsobjekt gespeichert wurden. Bei FALSE müssen Sie die IDynamicRenderer::ReleaseCachedData-Methode nicht aufrufen. Der Nachteil beim Festlegen dieser Eigenschaft auf FALSE besteht darin, dass alle Strichdaten, die anfänglich dynamisch gerendert wurden, aber von anderen verschiedenen Vorgängen ungültig gemacht wurden, erst gerendert werden, wenn die Strichdaten das Freihandsammlungsobjekt erreichen und dort gerendert werden.

Wenn Sie diese Eigenschaft auf FALSE festlegen, werden die zwischengespeicherten Daten gelöscht.

Anforderungen

Weitere Informationen

IDynamicRenderer-Schnittstelle

IDynamicRenderer::ReleaseCachedData-Methode