Top, propriété

S’applique à

Vous pouvez utiliser la propriété Top pour spécifier l’emplacement d’un objet sur un formulaire ou état. Entier en lecture/écriture pour tous les objets figurant dans la liste S’applique à, à l’exception de l’objet Report, qui est Long en lecture seule.

expression Obligatoire. Expression qui renvoie l’un des objets ci-dessus.

Remarques

L’emplacement d’un contrôle est la distance mesurée à partir de sa bordure gauche ou supérieure jusqu’à la bordure gauche ou supérieure de la section contenant le contrôle. Lorsque la propriété Top est définie sur 0, la bordure du contrôle est placée tout en haut de la section. Pour utiliser une unité de mesure différente de celle du paramètre défini dans la boîte de dialogue Options régionales du Panneau de configuration Windows, spécifiez l’unité, telle que cm ou po (par exemple, 3 cm ou 2 po).

Dans Visual Basic, utilisez une expression numérique pour définir la valeur de cette propriété. Les valeurs sont exprimées en twips.

Pour les contrôles, vous pouvez définir cette propriété en utilisant la feuille de propriétés d’un contrôle, une macro ou un code Visual Basic pour Applications (VBA).

Lorsque vous déplacez un contrôle, le nouveau paramètre de sa propriété Top est automatiquement entré dans la feuille de propriétés. Lorsque vous affichez un formulaire ou un état en mode Aperçu avant impression, ou lorsque vous imprimez un formulaire, l’emplacement d’un contrôle est déterminé par le paramètre de sa propriété Top ainsi que par les paramètres de marge de l’état, disponibles en cliquant sur Marges dans l’onglet Mise en Page.

Pour les états, le paramètre de la propriété Top correspond au décalage de la section active par rapport au haut de la page. Le paramètre de cette propriété est exprimé en twips. Vous pouvez utiliser cette propriété pour indiquer jusqu’où vous souhaitez qu’une section soit imprimée sur la page dans la procédure événementielle Format de la section.

Exemple

L’exemple suivant vérifie le paramètre de la propriété Top pour l’état actif. Si la valeur est inférieure au paramètre de marge minimum, les propriétés NextRecord et PrintSection sont définies sur False. La section ne passe pas à l’enregistrement suivant et la section suivante n’est pas imprimée.

Sub Detail1_Format(Cancel As Integer, _
    FormatCount As Integer)
Const conTopMargin = 1880
' Don't advance to next record or print next section
' if Top property setting is less than 1880 twips.
    If Me.Top < conTopMargin Then
        Me.NextRecord = False
        Me.PrintSection = False
    End If
End Sub