Geometry.Combine Método

Definição

Espaço de Nomes:: System.Windows.Media

Assemblagem:: PresentationCore.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Combina dois Geometry objetos.

Sobrecargas

Name	Description
Combine(Geometry, Geometry, GeometryCombineMode, Transform)	Combina as duas geometrias usando o especificado GeometryCombineMode e aplica a transformação especificada à geometria resultante.
Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)	Combina as duas geometrias usando o fator especificado GeometryCombineMode e o fator de tolerância, e aplica a transformação especificada à geometria resultante.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina as duas geometrias usando o especificado GeometryCombineMode e aplica a transformação especificada à geometria resultante.

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

Public Shared Function Combine (geometry1 As Geometry, geometry2 As Geometry, mode As GeometryCombineMode, transform As Transform) As PathGeometry

Parâmetros

geometry1: Geometry

A primeira geometria a combinar-se.

geometry2: Geometry

A segunda geometria a combinar.

mode: GeometryCombineMode

Um dos valores de enumeração que especifica como as geometrias são combinadas.

transform: Transform

Uma transformação para aplicar à geometria combinada, ou null.

Devoluções

PathGeometry

A geometria combinada.

Observações

Este método utiliza o fator de tolerância padrão (descrito pela StandardFlatteningTolerance propriedade) ao combinar geometrias. Para especificar o seu próprio fator de tolerância, use o Combine método.

Alguns Geometry métodos (como Combine) produzem ou usam uma aproximação poligonal da geometria. O fator de tolerância especifica a distância máxima entre pontos nesta aproximação poligonal. Valores de tolerância mais pequenos produzem melhores aproximações, mas requerem mais processamento do que uma aproximação com um fator de tolerância elevado.

Deve-se pensar cuidadosamente ao Combine usar uma união, pois pode ser muito dispendioso para o CPU. Na maioria dos casos, um GeometryGroup ou AddGeometry funciona melhor.

Use Combine apenas quando se aplicar qualquer uma das seguintes condições:

A operação geométrica não é uma união.
Qualquer uma das geometrias tem um FillRule valor de EvenOdd e as geometrias são auto-intersectantes (ou seja, realmente FillRule importam).
O tempo não é uma preocupação, mas o espaço é (por exemplo, se a geometria for criada uma vez e depois armazenada em cache). Tipicamente, Combine produz uma saída menor do que AddGeometry.
A geometria resultante será traçada ou usada numa animação de trajetória e AddGeometry não fornece o contorno desejado.

Aplica-se a

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

Combina as duas geometrias usando o fator especificado GeometryCombineMode e o fator de tolerância, e aplica a transformação especificada à geometria resultante.

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

Public Shared Function Combine (geometry1 As Geometry, geometry2 As Geometry, mode As GeometryCombineMode, transform As Transform, tolerance As Double, type As ToleranceType) As PathGeometry