StyleSet Klasse

Definition

Ein styleset ist eine Auflistung von Grafikobjekten, die von einer Anwendung verwendet werden können, um einen Satz von Stiften, Pinseln und Schriftarten anzugeben, die für alle Zeichnungsvorgänge verwendet werden sollen. Innerhalb des Zeichnungs Codes können Sie "styleset. getpen" aufrufen, um einen bestimmten, vom System definierten Stift abzurufen. Dieser Stift wird auf die richtige Farbe und den Stil festgelegt, die mit der Anwendung definiert werden. Verwenden Sie diesen Stift sofort, da er eindeutig ist. Wenn Sie einen Stift halten müssen, verwenden Sie getpencopy.

Stylesets können auf mehreren Ebenen im System Leben. Es gibt ein applicationstyleset, bei dem es sich um das von der APP definierte Standardschema handelt. Es gibt auch classstylesets, die auf der Klasse auf Klassenebene vorhanden sind, um Stile für alle Instanzen dieser Klasse von Form anzugeben. Es können auch instanzstylesets vorhanden sein, die Ressourcen Informationen für jede Instanz einer Form enthalten. Dies sollte verwendet werden, wenn verschiedene Instanzen derselben Klasse von Formen unterschiedlich aussehen können.

Wenn Sie tatsächlich versuchen, ein Objekt abzurufen, wie z. b. einen Stift, wird der styleset-Code die Vererbungs Kette von Instanz zu Klasse in Anwendungs stylesets nach oben verschoben, bis, wenn sucht, die zuerst die gesuchte Ressource enthält (entsprechend der Definition der ResourceID, die Sie anfordern).

public ref class StyleSet
public class StyleSet
type StyleSet = class
Public Class StyleSet
Vererbung
StyleSet

Konstruktoren

StyleSet(StyleSet)

Erstellt eine Instanz des stylesets, das die aktuelle mit ihrem übergeordneten Element verknüpft.

Eigenschaften

Parent

Ruft das übergeordnete Element dieses stylesets in der Vererbungs Kette ab. Ist NULL, wenn dies der applicationstyleset ist.

UseHighContrastColors

Ruft einen Wert ab, der angibt, ob dieses styleset in Farben mit hohem Kontrast aufgelöst wird.

Methoden

AddBrush(StyleSetResourceId, StyleSetResourceId, BrushSettings)

Fügen Sie diesem styleset einen neuen Pinsel hinzu.

AddFont(StyleSetResourceId, StyleSetResourceId, FontSettings)

Fügen Sie diesem styleset eine neue Schriftart hinzu.

AddPen(StyleSetResourceId, StyleSetResourceId, PenSettings)

Fügen Sie diesem styleset einen neuen Stift hinzu.

ClearBrushOverride(StyleSetResourceId)

Löscht einen außer Kraft gesetzten Pinsel im styleset.

ClearFontOverride(StyleSetResourceId)

Löscht eine über schreibende Schriftart im styleset.

ClearPenOverride(StyleSetResourceId)

Löscht einen außer Kraft gesetzten Stift im styleset.

GetBrush(StyleSetResourceId)

Ruft einen bestimmten Pinsel aus dem styleset ab. Wenn Sie sich nicht im aktuellen befindet, wird die übergeordnete Kette nachgeschlagen, um festzustellen, ob Sie dort gefunden werden kann. Dabei handelt es sich um einen Singleton. Nicht verwerfen: das wird abstürzen! Verwenden Sie sofort. Verwenden Sie getbrushcopy, wenn ein anderer Pinsel benötigt wird.

GetBrushCopy(StyleSetResourceId)

Ruft einen bestimmten Pinsel aus dem styleset ab. Wenn Sie sich nicht im aktuellen befindet, wird die übergeordnete Kette nachgeschlagen, um festzustellen, ob Sie dort gefunden werden kann. Dies ist eine Kopie. Der Aufrufer ist für die Freigabe verantwortlich.

GetFont(StyleSetResourceId)

Ruft eine bestimmte Schriftart aus dem styleset ab. Wenn Sie sich nicht im aktuellen befindet, wird die übergeordnete Kette nachgeschlagen, um festzustellen, ob Sie dort gefunden werden kann.

GetFontHeight(StyleSetResourceId)

Gibt den Zeilenabstand der angegebenen Schriftart (d. h. die Höhe einer Textzeile) in Welteinheiten zurück. Der Zeilenabstand ist der Anstieg und der Abstieg und einige empfohlene Zusatzzeichen. Der Anstieg ist die Höhe des Zeichens oberhalb der Baseline, und der Abstieg ist die Höhe des Zeichens unterhalb der Baseline. Der Zusatz liegt unter dem Abstieg.

GetFontSize(StyleSetResourceId)

Gibt die EM-Höhe der Schriftart mit der angegebenen ID zurück. Dies ist der Wert, der angegeben wurde, als die Schriftart erstellt wurde. Verwenden Sie stattdessen getfontheight, um die Höhe einer Textzeile bei Verwendung dieser Schriftart zu erhalten.

GetOverriddenBrushSettings(StyleSetResourceId)

Ruft ein brushsettings-Objekt ab, das Einstellungen enthält, die in diesem Stilsatz überschrieben wurden. Wenn keine Einstellungen überschrieben wurden, gibt diese Methode NULL zurück.

GetOverriddenFontSettings(StyleSetResourceId)

Ruft ein fontsettings-Objekt ab, das Einstellungen enthält, die in diesem Stilsatz überschrieben wurden. Wenn keine Einstellungen überschrieben wurden, gibt diese Methode NULL zurück.

GetOverriddenPenSettings(StyleSetResourceId)

Ruft ein "ksettings"-Objekt mit Einstellungen ab, die in diesem Stilsatz überschrieben wurden. Wenn keine Einstellungen überschrieben wurden, gibt diese Methode NULL zurück.

GetPen(StyleSetResourceId)

Ruft einen bestimmten Stift aus dem styleset ab. Wenn Sie sich nicht im aktuellen befindet, wird die übergeordnete Kette nachgeschlagen, um festzustellen, ob Sie dort gefunden werden kann. Dabei handelt es sich um einen Singleton. Nicht verwerfen: das wird abstürzen! Verwenden Sie sofort. Verwenden Sie getpencopy, wenn ein anderer Stift benötigt wird.

GetPenCopy(StyleSetResourceId)

Ruft einen bestimmten Stift aus dem styleset ab. Wenn Sie sich nicht im aktuellen befindet, wird die übergeordnete Kette nachgeschlagen, um festzustellen, ob Sie dort gefunden werden kann. Dies ist eine Kopie. Der Aufrufer ist für die Freigabe verantwortlich.

OverrideBrush(StyleSetResourceId, BrushSettings)

Überschreibt den angegebenen Pinsel im styleset.

OverrideBrushWorker(StyleSetResourceId, StyleSetResourceId, BrushSettings)

Überschreibt den angegebenen Pinsel im styleset.

OverrideFont(StyleSetResourceId, FontSettings)

Überschreibt die angegebene Schriftart im styleset.

OverrideFontWorker(StyleSetResourceId, StyleSetResourceId, FontSettings)

Überschreibt die angegebene Schriftart im styleset.

OverridePen(StyleSetResourceId, PenSettings)

Überschreibt den angegebenen Stift im styleset.

OverridePenWorker(StyleSetResourceId, StyleSetResourceId, PenSettings)

Überschreibt den angegebenen Stift im styleset.

RefreshResources(Boolean)

Erzwingt ggf. eine erneute Auflösung der Ressourcen. Die Ressourcen werden später aufgelöst, wenn Sie verwendet werden.

RemoveBrush(StyleSetResourceId)

Entfernt einen Pinsel aus diesem styleset.

RemoveFont(StyleSetResourceId)

Entfernt eine Schriftart aus diesem styleset.

RemovePen(StyleSetResourceId)

Entfernt einen Stift aus diesem styleset.

Gilt für