Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

FrameworkElement.MaxHeight, propriété

Mise à jour : novembre 2007

Obtient ou définit la contrainte de hauteur maximale applicable à l'élément. Il s'agit d'une propriété de dépendance.

Espace de noms :  System.Windows
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/xaml/presentation

[TypeConverterAttribute(typeof(LengthConverter))]
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public double MaxHeight { get; set; }
/** @property */
/** @attribute TypeConverterAttribute(LengthConverter) */
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
public double get_MaxHeight()
/** @property */
/** @attribute TypeConverterAttribute(LengthConverter) */
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
public  void set_MaxHeight(double value)

public function get MaxHeight () : double
public function set MaxHeight (value : double)
<object MaxHeight="double"/>
- or –
<object MaxHeight ="qualifiedDouble"/>
double Double 
                    Représentation sous forme de chaîne d'une valeur Double supérieure ou égale à 0,0. Interprétée comme une mesure exprimée en unité indépendante du périphérique (1/96ème de pouce). Les chaînes n'incluent pas explicitement le séparateur décimal. Par exemple, la valeur 1 est acceptable. 
                
                    Le même Double applique des restrictions tel qu'il est mentionné au paragraphe Valeur de la propriété, mais vous devez utiliser x:Static, extension de balisage si vous devez affecter explicitement une valeur PositiveInfinity.
                qualifiedDouble
                    Valeur double telle que décrite ci-dessus, suivie de l'une des chaînes de déclaration d'unité suivantes : px, in, cm ou pt.
                 px La valeur  (par défaut) est exprimée en  unités indépendantes du périphérique (1/96ème de pouce par unité)
                 in est l'abréviation du mot anglais « inches » (pouces) ; 1 in = 96 px
                 cm est l'abréviation de centimètres ; 1 cm = (96/2,54) px
                 pt est l'abréviation de point ; 1 pt = (96/72) px
                

Valeur de propriété

Type : System.Double

Hauteur maximale de l'élément, en unités indépendantes du périphérique (1/96ème de pouce par unité). La valeur par défaut est PositiveInfinity. Cette valeur peut être égale ou supérieure à 0,0. PositiveInfinity est également valide.

Champ d'identificateur

MaxHeightProperty

Propriétés de métadonnées ayant la valeur true

AffectsMeasure

Elle correspond à l'une de trois propriétés sur FrameworkElement qui donne les informations sur la hauteur. Les deux autres sont MinHeight et Height. Si un conflit se présente entre ces valeurs, l'ordre d'application pour la détermination de la hauteur réelle est le suivant : l'attribut MinHeight doit être honoré en premier, puis MaxHeight, et enfin, si chacune de ces valeurs se trouvent dans les limites, Height.

Les restrictions de valeurs sur Double sont appliquées par un mécanisme de ValidateValueCallback. Si vous essayez d'affecter une valeur non valide, une exception d'exécution est levée.

Cet exemple montre visuellement les différences de rendu d'un comportement dans Windows Presentation Foundation (WPF), parmi les quatre propriétés associées à la hauteur.

La classe FrameworkElement expose quatre propriétés qui décrivent les caractéristiques de hauteur d'un élément. Ces quatre propriétés peuvent entrer en conflit et, lorsque c'est le cas, la valeur prioritaire est déterminée comme suit : la valeur MinHeight est prioritaire sur la valeur MaxHeight qui, elle-même, est prioritaire sur la valeur Height. La quatrième propriété, soit ActualHeight, est en lecture seule.

Les exemples XAML (Extensible Application Markup Language) suivants dessinent un élément Rectangle (rect1) comme enfant de Canvas. Vous pouvez modifier les propriétés de hauteur d'un Rectangle à l'aide d'une série de zones de liste qui représentent les valeurs de propriété MinHeight, MaxHeight et Height. De cette manière, la priorité de chaque propriété est affichée visuellement.

<Canvas Height="200" MinWidth="200" Background="#b0c4de" VerticalAlignment="Top"  HorizontalAlignment="Center" Name="myCanvas" Margin="0,0,0,50">
    <Rectangle HorizontalAlignment="Center" Canvas.Top="50" Canvas.Left="50"  Name="rect1" Fill="#4682b4" Height="100" Width="100"/>
</Canvas>


...

    <TextBlock Grid.Row="1" Grid.Column="0" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle Height:</TextBlock>
    <ListBox Grid.Column="1" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
    </ListBox>

	<TextBlock Grid.Row="1" Grid.Column="2" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MinHeight:</TextBlock>
    <ListBox Grid.Column="3" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeMinHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
  </ListBox>      

    <TextBlock Grid.Row="1" Grid.Column="4" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MaxHeight:</TextBlock>
    <ListBox Grid.Column="5" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeMaxHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem> 
    </ListBox>


Les exemples de code-behind suivants gèrent les événements déclenchés par l'événement SelectionChanged. Chaque méthode personnalisée extrait l'entrée de la ListBox, analyse la valeur en tant que Double et applique la valeur à la propriété associée à la hauteur spécifiée. Les valeurs de hauteur sont également converties en chaîne et écrites dans un élément TextBlock appelé txt1.

private void changeHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.Height = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}
private void changeMinHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MinHeight = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}
private void changeMaxHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MaxHeight = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}


Pour l'exemple complet, consultez Propriétés Height, exemple.

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0

Ajouts de la communauté

Afficher:
© 2014 Microsoft