UIElement.ClipToBounds Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Obtém ou define um valor indicando se o conteúdo deste elemento (ou conteúdo proveniente dos filhos deste elemento) deve ser recortado para caber dentro do espaço do elemento que o 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

Boolean

true se for necessário recortar o conteúdo; 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 determinados porWidth / Height 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 qualquer determinado elemento derivado substitua os metadados da UIElement propriedade de dependência para essa propriedade nessa instância como 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 substituirá 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 outro valor para ClipToBounds atribuído 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 deseja permitir o clipe 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 de dependência

Campo Identificador	ClipToBoundsProperty
Propriedades de metadados definidas como true	Nenhum

Confira também

• Clip