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 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, setPublic Property ClipToBounds As BooleanValor da propriedade
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 |