Développer Réduire

UIElement.Opacity Property

Obtient ou définit le degré d'opacité de l'objet.

Syntaxe


public double Opacity { get; set; }


<uiElement Opacity="double" .../>

Valeur de propriété

Type: System.Double [.NET] | float64 [C++]

Une valeur comprise entre 0 et 1.0 qui déclare le facteur d'opacité, 1.0 signifiant l'opacité complète et 0 la transparence. La valeur par défaut est 1,0.

Remarques

Lorsque Opacity a la valeur 0, un objet n'est pas exclu du test de positionnement. Ce comportement peut être utile pour créer des superpositions de style Imagemap de Canvas, Rectangle ou d'autres formes pour la capture d'accès sur des objets qui existent dans des ordres de plan supérieurs à d'autres objets visibles. Pour exclure un objet des tests de positionnement, vous devez attribuer à IsHitTestVisible la valeur False.

Si Opacity a la valeur d'objets imbriqués, l'opacité effective est le produit de tous les facteurs d'opacité applicables. Par exemple, si un objet dont la valeur est Opacity=0.5 est contenu dans un objet Canvas dont la valeur est également Opacity=0.5, la valeur Opacity effective est 0.25. Les valeurs d'opacité supérieures à 1.0 sont traitées comme si elles étaient égales à 1.0, bien que l'obtention de la valeur de la propriété donne encore la valeur d'origine supérieure à 1. Les valeurs d'opacité inférieures à 0 sont traitées comme si elles étaient égales à 0. Par exemple, attribuer la valeur 2 à Opacity pour annuler les effets d'un élément contenu par un objet dont la valeur Opacity est égale à 0,5 ne fonctionne pas ; la valeur 2 est traitée comme si elle était égale à 1,0, y compris avant le calcul de la factorisation de l'objet imbriqué.

Exemples

Cet exemple utilise Storyboard et DoubleAnimation pour cibler Opacity. Cela anime la propriété Opacity pour créer une animation à apparition en fondu décorative spécifique à l'application dans un délai d'une seconde.


  <UserControl x:Class="animation_ovw_intro.Page"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  Width="400" Height="300">

  <StackPanel>
    <StackPanel.Resources>
      <!-- Animates the rectangle's opacity. -->
      <Storyboard x:Name="myStoryboard">
        <DoubleAnimation
          Storyboard.TargetName="MyAnimatedRectangle"
          Storyboard.TargetProperty="Opacity"
          From="1.0" To="0.0" Duration="0:0:1" 
          AutoReverse="True" 
          RepeatBehavior="Forever"/>
       </Storyboard>
    </StackPanel.Resources>
    <TextBlock Margin="10">Click on the rectangle to start the animation.</TextBlock>

    <Rectangle PointerPressed="Item_Clicked"
      x:Name="MyAnimatedRectangle"
      Width="100" Height="100" Fill="Blue" />

  </StackPanel>
</UserControl>


Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Métadonnées

Windows.winmd

Voir aussi

UIElement
Événements d'entrée et tests de positionnement

 

 

Afficher:
© 2014 Microsoft