UIElement.ClipToBounds Propriedade

Definição

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.Gets or sets a value indicating whether to clip the content of this element (or content coming from the child elements of this element) to fit into the size of the containing element. É uma propriedade de dependência.This is a dependency property.

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 for necessário recortar o conteúdo; caso contrário, false.true if the content should be clipped; otherwise, false. O valor padrão é false.The default value is false.

Comentários

Para elementos filho, ClipToBounds tem efeitos diferentes sobre comportamentos de layout dependendo se a altura e a largura do elemento pai estão sendo determinadas por Height / Width ou MaxHeight / MaxWidth.For child elements, ClipToBounds has different effects on layout behaviors depending on whether the height and width of the parent element are being determined by Height / Width or MaxHeight / MaxWidth. MaxHeight / MaxWidth do elemento pai são sempre respeitadas, independentemente do valor de ClipToBounds e o recorte efetivo sempre cortará o conteúdo com base nesses máximos.MaxHeight / MaxWidth of the parent element are always respected regardless of the value of ClipToBounds and the effective clipping will always clip the content based on these maximums. O Heightdo pai / configurações de Width não cortará o conteúdo quando ClipToBounds for false, mas cortará o conteúdo se ClipToBounds for true.The parent's Height / Width settings will not clip the content when ClipToBounds is false, but will clip the content if ClipToBounds is true.

Observe que o padrão para false é o comportamento geral conforme implementado na classe UIElement.Note that defaulting to false is the general behavior as implemented in the UIElement class. É possível para qualquer elemento dado que derive de UIElement para substituir os metadados de propriedade de dependência para essa propriedade nessa instância para, por padrão, true.It is possible for any given element that derives from UIElement to override the dependency property metadata for this property in that instance to default to true instead. Várias classes derivadas existentes substituem esses metadados e/ou ajustam o valor padrão da propriedade de dependência.Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresentere Popup cada um substitui o valor padrão a ser true.InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElement substitui os metadados para essa propriedade de dependência.FrameworkElement overrides the metadata for this dependency property. Especificamente, FrameworkElement designa essa propriedade para permitir a herança de valor de propriedade (Inherits é true nos metadados).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). A herança de valor de propriedade neste contexto significa que, se houver elementos filho sem 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.Property value inheritance in this context means that if there are child elements with no other value for ClipToBounds assigned through local values or styles, the value of the nearest parent element with this value assigned (again, either in styles, by default values, or a locally value), then the value from the parent element will be assigned to all unassigned child elements by the property system. Na prática, isso significa que você pode especificar se deseja permitir que o clipe seja associado no elemento raiz, e esse valor será propagado para todos os elementos filho que não o atribuiram especificamente como false.In practice this means that you can specify whether to allow clip to bounds at the root element, and that value will propagate to all child elements that have not specifically assigned it as false.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field ClipToBoundsProperty
Propriedades de metadados definidas como trueMetadata properties set to true NenhumNone

Aplica-se a

Veja também