Geometry.Combine Metodo

Definizione

Combina due oggetti Geometry.Combines two Geometry objects.

Overload

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina le due geometrie utilizzando il metodo GeometryCombineMode specificato e applica la trasformazione specificata alla geometria risultante.Combines the two geometries using the specified GeometryCombineMode and applies the specified transform to the resulting geometry.

Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)

Combina le due geometrie utilizzando il metodo GeometryCombineMode e il fattore di tolleranza specificati e applica la trasformazione specificata alla geometria risultante.Combines the two geometries using the specified GeometryCombineMode and tolerance factor, and applies the specified transform to the resulting geometry.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina le due geometrie utilizzando il metodo GeometryCombineMode specificato e applica la trasformazione specificata alla geometria risultante.Combines the two geometries using the specified GeometryCombineMode and applies the specified transform to the resulting geometry.

public:
 static System::Windows::Media::PathGeometry ^ Combine(System::Windows::Media::Geometry ^ geometry1, System::Windows::Media::Geometry ^ geometry2, System::Windows::Media::GeometryCombineMode mode, System::Windows::Media::Transform ^ transform);
public static System.Windows.Media.PathGeometry Combine (System.Windows.Media.Geometry geometry1, System.Windows.Media.Geometry geometry2, System.Windows.Media.GeometryCombineMode mode, System.Windows.Media.Transform transform);
static member Combine : System.Windows.Media.Geometry * System.Windows.Media.Geometry * System.Windows.Media.GeometryCombineMode * System.Windows.Media.Transform -> System.Windows.Media.PathGeometry

Parametri

geometry1
Geometry

Prima geometria da combinare.The first geometry to combine.

geometry2
Geometry

Seconda geometria da combinare.The second geometry to combine.

mode
GeometryCombineMode

Uno dei valori di enumerazione che specifica il modo in cui vengono combinate le geometrie.One of the enumeration values that specifies how the geometries are combined.

transform
Transform

Trasformazione da applicare alla geometria combinata oppure null.A transformation to apply to the combined geometry, or null.

Restituisce

Geometria combinata.The combined geometry.

Commenti

Questo metodo usa il fattore di tolleranza predefinito (descritto dalla StandardFlatteningTolerance proprietà) quando si combinano le geometrie.This method uses the default tolerance factor (described by the StandardFlatteningTolerance property) when combining geometries. Per specificare un fattore di tolleranza personalizzato, utilizzare Combine il metodo.To specify your own tolerance factor, use the Combine method.

Alcuni Geometry metodi, Combinead esempio, producono o usano un'approssimazione poligonale della geometria.Some Geometry methods (such as Combine) produce or use a polygonal approximation of the geometry. Il fattore di tolleranza specifica la distanza massima tra i punti nell'approssimazione poligonale.The tolerance factor specifies the maximum distance between points in this polygonal approximation. I valori di tolleranza inferiori producono approssimazioni migliori, ma richiedono una maggiore elaborazione rispetto a un'approssimazione con un fattore di tolleranza grande.Smaller tolerance values produce better approximations, but require more processing than an approximation with a large tolerance factor.

È necessario prestare attenzione quando si usa Combine per eseguire un'Unione in quanto può essere molto dispendiosa dalla CPU.Careful thought should be involved when using Combine to perform a union as it can be very CPU-expensive. Nella maggior parte dei casi GeometryGroup , AddGeometry un o funzionerà meglio.In most cases, a GeometryGroup or AddGeometry will work better.

Utilizzare Combine solo quando si applica una delle condizioni seguenti:Use Combine only when any of the following apply:

  • L'operazione geometrica non è un'Unione.The geometric operation is not a union.

  • Una delle geometrie ha un FillRule EvenOdd valore e le geometrie sono autointersecate, ovvero la FillRule realtà è importante.Either of the geometries has a FillRule value of EvenOdd and the geometries are self-intersecting (i.e. the FillRule actually matters).

  • L'ora non rappresenta un problema, ma lo spazio è (ad esempio, se la geometria viene creata una sola volta e quindi memorizzata nella cache).Time is not a concern, but space is (for instance, if the geometry is created once and then cached). In genere Combine , produce un output AddGeometrypiù piccolo rispetto a.Typically, Combine produces smaller output than AddGeometry.

  • La geometria risultante verrà tracciata o utilizzata in un'animazione del percorso e AddGeometry non fornirà la struttura desiderata.The resulting geometry will be stroked or used in a path animation and AddGeometry does not provide the desired outline.

Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)

Combina le due geometrie utilizzando il metodo GeometryCombineMode e il fattore di tolleranza specificati e applica la trasformazione specificata alla geometria risultante.Combines the two geometries using the specified GeometryCombineMode and tolerance factor, and applies the specified transform to the resulting geometry.

public:
 static System::Windows::Media::PathGeometry ^ Combine(System::Windows::Media::Geometry ^ geometry1, System::Windows::Media::Geometry ^ geometry2, System::Windows::Media::GeometryCombineMode mode, System::Windows::Media::Transform ^ transform, double tolerance, System::Windows::Media::ToleranceType type);
public static System.Windows.Media.PathGeometry Combine (System.Windows.Media.Geometry geometry1, System.Windows.Media.Geometry geometry2, System.Windows.Media.GeometryCombineMode mode, System.Windows.Media.Transform transform, double tolerance, System.Windows.Media.ToleranceType type);
static member Combine : System.Windows.Media.Geometry * System.Windows.Media.Geometry * System.Windows.Media.GeometryCombineMode * System.Windows.Media.Transform * double * System.Windows.Media.ToleranceType -> System.Windows.Media.PathGeometry

Parametri

geometry1
Geometry

Prima geometria da combinare.The first geometry to combine.

geometry2
Geometry

Seconda geometria da combinare.The second geometry to combine.

mode
GeometryCombineMode

Uno dei valori di enumerazione che specifica il modo in cui vengono combinate le geometrie.One of the enumeration values that specifies how the geometries are combined.

transform
Transform

Trasformazione da applicare alla geometria combinata oppure null.A transformation to apply to the combined geometry, or null.

tolerance
Double

Limiti massimi della distanza tra i punti nell'approssimazione poligonale delle geometrie.The maximum bounds on the distance between points in the polygonal approximation of the geometries. Valori inferiori producono risultati più precisi ma possono rallentare l'esecuzione.Smaller values produce more accurate results but cause slower execution. Se tolerance è minore di .000001, viene utilizzato .000001.If tolerance is less than .000001, .000001 is used instead.

type
ToleranceType

Uno dei valori ToleranceType che specifica se il fattore di tolleranza è un valore assoluto o un valore relativo all'area della geometria.One of the ToleranceType values that specifies whether the tolerance factor is an absolute value or relative to the area of the geometry.

Restituisce

Geometria combinata.The combined geometry.

Commenti

Alcuni Geometry metodi, Combinead esempio, producono o usano un'approssimazione poligonale della geometria.Some Geometry methods (such as Combine) produce or use a polygonal approximation of the geometry. Il fattore di tolleranza specifica la distanza massima tra i punti nell'approssimazione poligonale.The tolerance factor specifies the maximum distance between points in this polygonal approximation. I valori di tolleranza inferiori producono approssimazioni migliori, ma richiedono una maggiore elaborazione rispetto a un'approssimazione con un fattore di tolleranza grande.Smaller tolerance values produce better approximations, but require more processing than an approximation with a large tolerance factor.

È necessario prestare attenzione quando si usa Combine per eseguire un'Unione in quanto può essere molto dispendiosa dalla CPU.Careful thought should be involved when using Combine to perform a union as it can be very CPU-expensive. Nella maggior parte dei casi GeometryGroup , AddGeometry un o funzionerà meglio.In most cases, a GeometryGroup or AddGeometry will work better.

Utilizzare Combine solo quando si applica una delle condizioni seguenti:Use Combine only when any of the following apply:

  • L'operazione geometrica non è un'Unione.The geometric operation is not a union.

  • Una delle geometrie ha un FillRule EvenOdd valore e le geometrie sono autointersecate, ovvero la FillRule realtà è importante.Either of the geometries has a FillRule value of EvenOdd and the geometries are self-intersecting (i.e. the FillRule actually matters).

  • L'ora non rappresenta un problema, ma lo spazio è (ad esempio, se la geometria viene creata una sola volta e quindi memorizzata nella cache).Time is not a concern, but space is (for instance, if the geometry is created once and then cached). In genere Combine , produce un output AddGeometrypiù piccolo rispetto a.Typically, Combine produces smaller output than AddGeometry.

  • La geometria risultante verrà tracciata o utilizzata in un'animazione del percorso e AddGeometry non fornirà la struttura desiderata.The resulting geometry will be stroked or used in a path animation and AddGeometry does not provide the desired outline.

Si applica a