ContainerVisual Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ein Knoten in der visuellen Struktur, der untergeordnete Elemente aufweisen kann.
[WebHostHidden]
public ref class ContainerVisual : Visual/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
class ContainerVisual : Visual/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class ContainerVisual : Visual[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ContainerVisual : Visual[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class ContainerVisual : VisualPublic Class ContainerVisual
Inherits Visual- Vererbung
- Abgeleitet
- Attribute
Beispiele
// RootGrid is a XAML Grid element.
Compositor compositor = ElementCompositionPreview.GetElementVisual(RootGrid).Compositor;
ContainerVisual root = compositor.CreateContainerVisual();
SpriteVisual child = compositor.CreateSpriteVisual();
child.Brush = compositor.CreateColorBrush(Color.FromArgb(0xFF, 0x00, 0xCC, 0x00));
child.Offset = new Vector2(50.0f, 50.0f);
child.Size = new Vector2(200, 200);
root.Children.InsertAtTop(child);
// App.cpp
struct SampleApp : implements<SampleApp, IFrameworkViewSource, IFrameworkView>
{
...
void SetWindow(CoreWindow const& /* window */)
{
// Set up Composition.
m_compositor = Compositor{};
m_target = m_compositor.CreateTargetForCurrentView();
m_root = m_compositor.CreateContainerVisual();
m_target.Root(m_root);
// Create a simple scene.
auto child{ m_compositor.CreateSpriteVisual() };
child.Brush(m_compositor.CreateColorBrush(ColorHelper::FromArgb(0xFF, 0x00, 0xCC, 0x00)));
child.Offset({ 50.f, 50.f, 0.f });
child.Size({ 200.f, 200.f });
m_root.Children().InsertAtTop(child);
}
private:
Compositor m_compositor{ nullptr };
CompositionTarget m_target{ nullptr };
ContainerVisual m_root{nullptr};
};
Eigenschaften
| Name | Beschreibung |
|---|---|
| AnchorPoint |
Der Punkt auf dem visuellen Element, der am Offset des visuellen Elements positioniert werden soll. Der Wert wird in Bezug auf die Größe des visuellen Elements normalisiert. Animierbar. (Geerbt von Visual) |
| BackfaceVisibility |
Gibt an, ob die Rückseite des visuellen Elements während einer 3D-Transformation sichtbar sein soll. (Geerbt von Visual) |
| BorderMode |
Gibt an, wie die Kanten von Bitmaps und Clips erstellt werden, die einem visuellen Element zugeordnet sind, oder mit allen visuellen Elementen in der unterstruktur, die an diesem visuellen Element verwurzelt sind. Das Festlegen von BorderMode bei einem übergeordneten Visuellen Element wirkt sich auf alle untergeordneten visuellen Elemente in der Unterstruktur aus und kann bei jedem untergeordneten visuellen Element selektiv deaktiviert werden. (Geerbt von Visual) |
| CenterPoint |
Der Punkt, an dem Drehung oder Skalierung auftritt. Animatable (Geerbt von Visual) |
| Children |
Die untergeordneten Elemente des ContainersVisual. |
| Clip |
Gibt den Clippingbereich für das visuelle Element an. Wenn ein visuelles Element gerendert wird, wird nur der Teil des visuellen Elements angezeigt, der in den Clippingbereich fällt, während alle Inhalte, die sich außerhalb des Beschneidungsbereichs erstrecken (d. a. nicht angezeigt) abgeschnitten werden. (Geerbt von Visual) |
| Comment |
Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject) |
| CompositeMode |
Gibt an, wie die Bitmap einer visuellen Grafik mit dem Bildschirm kombiniert wird. (Geerbt von Visual) |
| Compositor |
Der Kompositor , der zum Erstellen dieses CompositionObjects verwendet wurde. (Geerbt von CompositionObject) |
| DispatcherQueue |
Ruft den DispatcherQueue für das CompositionObject ab. (Geerbt von CompositionObject) |
| ImplicitAnimations |
Die Auflistung impliziter Animationen, die diesem Objekt zugeordnet sind. (Geerbt von CompositionObject) |
| IsHitTestVisible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die visuelle Unterstruktur, die an diesem visuellen Element verwurzelt ist, an Treffertests teilnimmt. (Geerbt von Visual) |
| IsPixelSnappingEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kompositionsmodul das gerenderte visuelle Element an einer Pixelgrenze ausgerichtet. (Geerbt von Visual) |
| IsVisible |
Gibt an, ob die visuelle und die gesamte Unterstruktur untergeordneter visueller Elemente sichtbar ist. (Geerbt von Visual) |
| Offset |
Der Offset des visuellen Elements relativ zum übergeordneten Element oder für ein Stammelement, das den Offset relativ zur oberen linken Ecke der Fenster darstellt, die das visuelle Element hosten. Animierbar. (Geerbt von Visual) |
| Opacity |
Die Deckkraft des visuellen Elements. Animierbar. Die Deckkrafteigenschaft bestimmt die Transparenz (sofern vorhanden) des visuellen Elements und ist ein Wert von 0 bis 1. 0 ist vollständig transparent und 1 ist voll undurchsichtig. Ein Visuelles Element mit einer Deckkrafteigenschaft von 0 ist noch in der Struktur vorhanden. Wie andere Eigenschaften des visuellen Elements können Opacity mithilfe der Windows,UI animiert werden. Kompositionsanimationssystem. (Geerbt von Visual) |
| Orientation |
Eine Quaternion, die eine Ausrichtung und Drehung im 3D-Raum beschreibt, die auf das visuelle Element angewendet wird. Animierbar. (Geerbt von Visual) |
| Parent |
Das übergeordnete Element des visuellen Elements. (Geerbt von Visual) |
| ParentForTransform |
Visuelles Angeben des Koordinatensystems, in dem dieses visuelle Element zusammengesetzt ist. (Geerbt von Visual) |
| Properties |
Die Auflistung der Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject) |
| RelativeOffsetAdjustment |
Gibt den Offset des visuellen Elements in Bezug auf die Größe des übergeordneten visuellen Elements an. (Geerbt von Visual) |
| RelativeSizeAdjustment |
Ruft die Größe des visuellen Elements in Bezug auf die Größe des übergeordneten visuellen Elements ab oder legt diese fest. (Geerbt von Visual) |
| RotationAngle |
Der Drehwinkel im Bogenmaß des visuellen Elements. Animierbar. (Geerbt von Visual) |
| RotationAngleInDegrees |
Der Drehwinkel des visuellen Elements in Grad. Animierbar. (Geerbt von Visual) |
| RotationAxis |
Die Achse zum Drehen des visuellen Elements. Animierbar. (Geerbt von Visual) |
| Scale |
Die Skalierung, die auf das visuelle Element angewendet werden soll. (Geerbt von Visual) |
| Size |
Die Breite und Höhe des visuellen Elements. Animierbar. (Geerbt von Visual) |
| TransformMatrix |
Die Transformationsmatrix, die auf das visuelle Element angewendet werden soll. Animierbar. (Geerbt von Visual) |
Methoden
| Name | Beschreibung |
|---|---|
| Close() |
Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject) |
| Dispose() |
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (Geerbt von CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Startet eine Animationsgruppe. Mit der StartAnimationGroup-Methode auf CompositionObject können Sie CompositionAnimationGroup starten. Alle Animationen in der Gruppe werden gleichzeitig für das Objekt gestartet. (Geerbt von CompositionObject) |
| StopAnimation(String) |
Trennt eine Animation von der angegebenen Eigenschaft und stoppt die Animation. (Geerbt von CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Beendet eine Animationsgruppe. (Geerbt von CompositionObject) |
| TryGetAnimationController(String) |
Gibt einen AnimationController für die Animation zurück, die auf der angegebenen Eigenschaft ausgeführt wird. (Geerbt von CompositionObject) |