TileBrush Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Descreve uma maneira de pintar uma região usando um ou mais blocos.
public ref class TileBrush abstract : System::Windows::Media::Brush
public abstract class TileBrush : System.Windows.Media.Brush
type TileBrush = class
inherit Brush
Public MustInherit Class TileBrush
Inherits Brush
- Herança
- Derivado
Comentários
As classes derivadas de TileBrush definir o conteúdo dos blocos que você usa para pintar uma região. Por exemplo, use a ImageBrush classe para pintar uma área usando uma imagem.
Use um TileBrush para controlar como você pinta uma área. Por exemplo, o Windows Presentation Foundation (WPF) fornece vários tipos de pincéis:
Para pintar usando uma imagem, use o ImageBrush.
Para pintar desenhando, use o DrawingBrush.
Para pintar usando um Visual, use o VisualBrush.
Quando você usa a TileBrush para pintar uma área, em vez de pintar uma área usando uma única imagem estendida, você pode pintar uma área usando uma série de blocos de imagem que criam um padrão.
Ao pintar uma área usando um TileBrush, você usa três componentes: conteúdo, blocos e a área de saída. As ilustrações a seguir mostram como esses três TileBrush componentes se relacionam entre si.
Componentes de um TileBrush com um único bloco
Componentes de um TileBrush com um TileMode de bloco
Conteúdo: A TileBrush pode ter diferentes tipos de conteúdo:
Se o pincel for um ImageBrush, esse conteúdo será uma imagem. A ImageSource propriedade especifica o conteúdo do ImageBrush.
Se o pincel for um DrawingBrush, esse conteúdo será um desenho. A Drawing propriedade especifica o conteúdo do DrawingBrush.
Se o pincel for um VisualBrush, esse conteúdo será um visual. A Visual propriedade especifica o conteúdo do VisualBrush.
Você pode especificar a posição e as dimensões do TileBrush conteúdo usando a Viewbox propriedade.
Blocos: A TileBrush produz um ou mais blocos. Por padrão, o conteúdo do pincel é estendido para preencher um único bloco e esse bloco é estendido para preencher a área de saída. A Viewport propriedade é usada para especificar o tamanho e a posição do bloco base para o TileBrush. A ViewportUnits propriedade determina se o tamanho e a Viewport posição do são relativos à área de saída (o comportamento padrão) ou se são valores absolutos.
Área de saída: a área de saída é a área que o pincel pinta, como a Fill de um Ellipse ou de Background um Button.
Para obter mais informações sobre a TileBrush classe, consulte Pintura com Imagens, Desenhos e Visuais .
Recursos do Freezable
A TileBrush é um Freezable tipo. Para obter informações sobre Freezable recursos, como congelamento e clonagem, consulte a Visão geral dos objetos freezable.
Notas aos Implementadores
Quando você herda da TileBrush classe, deve substituir o CreateInstanceCore() método. Para obter mais informações sobre como herdar de Freezable tipos, consulte a Visão geral de objetos freezable.
Construtores
| Nome | Description |
|---|---|
| TileBrush() |
Fornece inicialização para valores de classe base quando chamado pelo construtor de uma classe derivada. |
Campos
| Nome | Description |
|---|---|
| AlignmentXProperty |
Identifica a AlignmentX propriedade de dependência. |
| AlignmentYProperty |
Identifica a AlignmentY propriedade de dependência. |
| StretchProperty |
Identifica a Stretch propriedade de dependência. |
| TileModeProperty |
Identifica a TileMode propriedade de dependência. |
| ViewboxProperty |
Identifica a Viewbox propriedade de dependência. |
| ViewboxUnitsProperty |
Identifica a ViewboxUnits propriedade de dependência. |
| ViewportProperty |
Identifica a Viewport propriedade de dependência. |
| ViewportUnitsProperty |
Identifica a ViewportUnits propriedade de dependência. |
Propriedades
| Nome | Description |
|---|---|
| AlignmentX |
Obtém ou define o alinhamento horizontal do conteúdo no TileBrush bloco base. |
| AlignmentY |
Obtém ou define o alinhamento vertical do conteúdo no TileBrush bloco base. |
| CanFreeze |
Obtém um valor que indica se o objeto pode ser tornado inmodificável. (Herdado de Freezable) |
| DependencyObjectType |
Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject) |
| Dispatcher |
Obtém o Dispatcher que DispatcherObject está associado. (Herdado de DispatcherObject) |
| HasAnimatedProperties |
Obtém um valor que indica se um ou mais AnimationClock objetos estão associados a qualquer uma das propriedades de dependência desse objeto. (Herdado de Animatable) |
| IsFrozen |
Obtém um valor que indica se o objeto é modificável no momento. (Herdado de Freezable) |
| IsSealed |
Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject) |
| Opacity |
Obtém ou define o grau de opacidade de um Brush. (Herdado de Brush) |
| RelativeTransform |
Obtém ou define a transformação que é aplicada ao pincel usando coordenadas relativas. (Herdado de Brush) |
| Stretch |
Obtém ou define um valor que especifica como o conteúdo disso TileBrush se estende para ajustar seus blocos. |
| TileMode |
Obtém ou define um valor que especifica como um TileBrush preenche a área que você está pintando se o bloco base é menor que a área de saída. |
| Transform |
Obtém ou define a transformação que é aplicada ao pincel. Essa transformação é aplicada depois que a saída do pincel é mapeada e posicionada. (Herdado de Brush) |
| Viewbox |
Obtém ou define a posição e as dimensões do conteúdo em um TileBrush bloco. |
| ViewboxUnits |
Obtém ou define um valor que especifica se o Viewbox valor é relativo à caixa delimitadora do TileBrush conteúdo ou se o valor é absoluto. |
| Viewport |
Obtém ou define a posição e as dimensões do bloco base para um TileBrush. |
| ViewportUnits |
Obtém ou define uma BrushMappingMode enumeração que especifica se o valor do Viewport, que indica o tamanho e a TileBrush posição do bloco base, é relativo ao tamanho da área de saída. |
Métodos
| Nome | Description |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Aplica-se a DependencyPropertyum AnimationClock . Se a propriedade já estiver animada, a especificada HandoffBehavior será usada. (Herdado de Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Aplica-se a DependencyPropertyum AnimationClock . Se a propriedade já estiver animada, o SnapshotAndReplace comportamento de entrega será usado. (Herdado de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Aplica uma animação ao especificado DependencyProperty. A animação é iniciada quando o próximo quadro é renderizado. Se a propriedade especificada já estiver animada, a especificada HandoffBehavior será usada. (Herdado de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Aplica uma animação ao especificado DependencyProperty. A animação é iniciada quando o próximo quadro é renderizado. Se a propriedade especificada já estiver animada, o SnapshotAndReplace comportamento de entrega será usado. (Herdado de Animatable) |
| CheckAccess() |
Determina se o thread de chamada tem acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject) |
| Clone() |
Cria uma cópia modificável disso TileBrush fazendo cópias profundas de seus valores. |
| CloneCore(Freezable) |
Torna a instância um clone (cópia profunda) dos valores de propriedade base (não animados) especificados Freezable . (Herdado de Freezable) |
| CloneCurrentValue() |
Cria uma cópia modificável desse TileBrush objeto fazendo cópias profundas de seus valores. Esse método não copia referências de recursos, associações de dados ou animações, embora copie seus valores atuais. |
| CloneCurrentValueCore(Freezable) |
Torna a instância um clone modificável (cópia profunda) do especificado Freezable usando valores de propriedade atuais. (Herdado de Freezable) |
| CoerceValue(DependencyProperty) |
Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer CoerceValueCallback função especificada nos metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject) |
| CreateInstance() |
Inicializa uma nova instância da classe Freezable. (Herdado de Freezable) |
| CreateInstanceCore() |
Quando implementado em uma classe derivada, cria uma nova instância da Freezable classe derivada. (Herdado de Freezable) |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente ao atual DependencyObject. (Herdado de DependencyObject) |
| Freeze() |
Torna o objeto atual inmodificável e define sua IsFrozen propriedade como |
| FreezeCore(Boolean) |
Torna esse Animatable objeto inmodificável ou determina se ele pode ser tornado inmodificável. (Herdado de Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Retorna o valor não animado do especificado DependencyProperty. (Herdado de Animatable) |
| GetAsFrozen() |
Cria uma cópia congelada dos valores de Freezablepropriedade base (não animados). Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência. (Herdado de Freezable) |
| GetAsFrozenCore(Freezable) |
Torna a instância um clone congelado dos valores de propriedade base (não animados) especificados Freezable . (Herdado de Freezable) |
| GetContentBounds(Rect) |
Obtém os limites atuais do TileBrush conteúdo. |
| GetCurrentValueAsFrozen() |
Cria uma cópia congelada do Freezable uso de valores de propriedade atuais. Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência. (Herdado de Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Torna a instância atual um clone congelado do especificado Freezable. Se o objeto tiver propriedades de dependência animadas, seus valores animados atuais serão copiados. (Herdado de Freezable) |
| GetHashCode() |
Obtém um código hash para isso DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente.DependencyObject (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnChanged() |
Chamado quando o objeto atual Freezable é modificado. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Garante que os ponteiros de contexto apropriados sejam estabelecidos para um DependencyObjectType membro de dados que acabou de ser definido. (Herdado de Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Substitui a DependencyObject implementação de OnPropertyChanged(DependencyPropertyChangedEventArgs) invocar também os Changed manipuladores em resposta a uma propriedade de dependência de alteração do tipo Freezable. (Herdado de Freezable) |
| ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject) |
| ReadPreamble() |
Garante que ele Freezable esteja sendo acessado de um thread válido. Os herdadores devem Freezable chamar esse método no início de qualquer API que leia os membros de dados que não são propriedades de dependência. (Herdado de Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente leitura, especificada pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| ToString() |
Retornar representação de cadeia de caracteres deste Brush. (Herdado de Brush) |
| ToString(IFormatProvider) |
Cria uma representação de cadeia de caracteres desse objeto com base nas informações de formatação específicas da cultura especificadas. (Herdado de Brush) |
| VerifyAccess() |
Impõe que o thread de chamada tenha acesso a isso DispatcherObject. (Herdado de DispatcherObject) |
| WritePostscript() |
Aciona o Changed evento para o Freezable método e invoca seu OnChanged() método. Classes das quais derivam Freezable devem chamar esse método no final de qualquer API que modifique os membros da classe que não são armazenados como propriedades de dependência. (Herdado de Freezable) |
| WritePreamble() |
Verifica se o Freezable não está congelado e se ele está sendo acessado de um contexto de threading válido. Freezable os herdadores devem chamar esse método no início de qualquer API que grava em membros de dados que não são propriedades de dependência. (Herdado de Freezable) |
Eventos
| Nome | Description |
|---|---|
| Changed |
Ocorre quando o objeto ou um Freezable objeto que ele contém é modificado. (Herdado de Freezable) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Formata o valor da instância atual usando o formato especificado. (Herdado de Brush) |