Geometry.Combine Método

  • Referência

Definição

Namespace:
System.Windows.Media
Assembly:
PresentationCore.dll

Combina dois objetos Geometry.

Sobrecargas

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina as duas geometrias usando o GeometryCombineMode especificado e aplica a transformação especificada à geometria resultante.
Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)

Combina as duas geometrias usando o GeometryCombineMode especificado 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 GeometryCombineMode especificado 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.

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 a ser aplicada à geometria combinada ou null.

Retornos

PathGeometry

A geometria combinada.

Comentários

Esse método usa o fator de tolerância padrão (descrito pela StandardFlatteningTolerance propriedade) ao combinar geometrias. Para especificar 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 os pontos nessa aproximação poligonal. Valores de tolerância menores produzem melhores aproximações, mas exigem mais processamento do que uma aproximação com um fator de tolerância grande.

O pensamento cuidadoso deve estar envolvido ao usar Combine para executar uma união, pois pode ser muito caro para a CPU. Na maioria dos casos, um GeometryGroup ou AddGeometry funcionará melhor.

Use Combine somente quando qualquer uma das seguintes aplicações:

  • A operação geométrica não é uma união.

  • Qualquer uma das geometrias tem um FillRule valor e EvenOdd as geometrias são auto-interseccionais (ou seja, as FillRule realmente importam).

  • O tempo não é uma preocupação, mas o espaço é (por exemplo, se a geometria é criada uma vez e depois armazenada em cache). Normalmente, Combine produz uma saída menor que AddGeometry.

  • A geometria resultante será traçada ou usada em uma animação de caminho e AddGeometry não fornece a estrutura de tópicos desejada.

Aplica-se a

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

Combina as duas geometrias usando o GeometryCombineMode especificado 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

Parâmetros

geometry1
Geometry

A primeira geometria a combinar.

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 a ser aplicada à geometria combinada ou null.

tolerance
Double

Os limites máximos na distância entre pontos na aproximação poligonal das geometrias. Valores menores produzem resultados mais precisos, mas causam a execução lenta. Se tolerance for menor que 0,000001, 0,000001 será usado.

type
ToleranceType

Um dos valores ToleranceType que especifica se o fator de tolerância é um valor absoluto ou relativo à área da geometria.

Retornos

PathGeometry

A geometria combinada.

Comentários

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 os pontos nessa aproximação poligonal. Valores de tolerância menores produzem melhores aproximações, mas exigem mais processamento do que uma aproximação com um fator de tolerância grande.

O pensamento cuidadoso deve estar envolvido ao usar Combine para executar uma união, pois pode ser muito caro para a CPU. Na maioria dos casos, um GeometryGroup ou AddGeometry funcionará melhor.

Use Combine somente quando qualquer uma das seguintes aplicações:

  • A operação geométrica não é uma união.

  • Qualquer uma das geometrias tem um FillRule valor e EvenOdd as geometrias são auto-interseccionais (ou seja, as FillRule realmente importam).

  • O tempo não é uma preocupação, mas o espaço é (por exemplo, se a geometria é criada uma vez e depois armazenada em cache). Normalmente, Combine produz uma saída menor que AddGeometry.

  • A geometria resultante será traçada ou usada em uma animação de caminho e AddGeometry não fornece a estrutura de tópicos desejada.

Aplica-se a