UIElement.ClipToBounds Propriedade

Definição

Obtém ou define um valor que indica se o conteúdo desse elemento (ou conteúdo proveniente dos elementos filho desse elemento) deve ser recortar no tamanho do elemento que contém. É uma propriedade de dependência.

public:
 property bool ClipToBounds { bool get(); void set(bool value); };
public bool ClipToBounds { get; set; }
member this.ClipToBounds : bool with get, set
Public Property ClipToBounds As Boolean

Valor da propriedade

true se o conteúdo deve ser recortado; caso contrário, false. O valor padrão é false.

Comentários

Para elementos filho, ClipToBounds tem efeitos diferentes nos comportamentos de layout, dependendo se a altura e a largura do elemento pai estão sendo determinadas porHeight / Width ou .MaxHeight / MaxWidth MaxHeight / MaxWidth do elemento pai são sempre respeitados independentemente do valor e ClipToBounds o recorte efetivo sempre cortará o conteúdo com base nesses máximos. As configurações do Height / Width pai não cortarão o conteúdo quando ClipToBounds estiver false, mas cortarão o conteúdo se ClipToBounds for true.

Observe que o false padrão é o comportamento geral, conforme implementado na UIElement classe. É possível que um determinado elemento que deriva de substituir os metadados da UIElement propriedade de dependência para essa propriedade nessa instância seja o padrão true . Várias classes derivadas existentes substituem esses metadados e/ou ajustam o valor padrão da propriedade de dependência.

InkCanvas, InkPresentere Popup cada um substitui o valor padrão a ser true.

FrameworkElement substitui os metadados dessa propriedade de dependência. Especificamente, FrameworkElement designa essa propriedade para permitir a herança do valor da propriedade (Inherits está true em metadados). A herança do valor da propriedade nesse contexto significa que, se houver elementos filho sem nenhum outro valor para ClipToBounds atribuídos por meio de valores ou estilos locais, o valor do elemento pai mais próximo com esse valor atribuído (novamente, em estilos, por valores padrão ou um valor local), o valor do elemento pai será atribuído a todos os elementos filho não atribuídos pelo sistema de propriedades. Na prática, isso significa que você pode especificar se o clipe deve ser permitido para limites no elemento raiz e esse valor será propagado para todos os elementos filho que não o atribuíram especificamente como false.

Informações da propriedade Dependency

Item Valor
Campo identificador ClipToBoundsProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também