UIElement.ClipToBounds Propriedade

Definição

Recebe ou define um valor que indica se deve recortar o conteúdo deste elemento (ou o conteúdo proveniente dos elementos filhos deste elemento) para caber no tamanho do elemento que o contém. Isto é 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 de Propriedade

true se o conteúdo deve ser cortado; caso contrário, false. O valor predefinido é false.

Observações

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

Note que o default para false é o comportamento geral implementado na UIElement classe. É possível que qualquer elemento derivado de UIElement sobrepone os metadados da propriedade de dependência dessa propriedade nessa ocasião por defeito true . Várias classes derivadas existentes sobrepõem estes metadados e/ou ajustam o valor padrão da propriedade de dependência.

InkCanvas, InkPresenter, e Popup cada um sobrescreve o valor padrão para ser true.

FrameworkElement sobrepõe os metadados desta propriedade de dependência. Especificamente, FrameworkElement designa esta propriedade para permitir a herança do valor da propriedade (Inherits está true nos metadados). Herança de valor de propriedade neste contexto significa que, se existirem elementos filhos sem outro valor atribuído ClipToBounds através de valores ou estilos locais, o valor do elemento pai mais próximo com esse valor atribuído (novamente, seja em estilos, valores por defeito, ou um valor local), então o valor do elemento pai será atribuído a todos os elementos filhos não atribuídos pelo sistema de propriedades. Na prática, isto significa que pode especificar se permite clipar limites no elemento raiz, e esse valor propagar-se-á para todos os elementos filhos que não o tenham especificamente atribuído como false.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador ClipToBoundsProperty
Propriedades dos metadados definidas como true None

Aplica-se a

Ver também