UIElement.ClipToBounds Propriedade
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.
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 |