Méthode Application.BoxFormatEx (Project)

Article
04/07/2023

Met en forme des zones individuelles dans la vue Diagramme réseau (graphique PERT), où les couleurs peuvent être spécifiées avec des valeurs hexadécimales.

Syntaxe

expression. BoxFormatEx( _ProjectName_, _TaskID_, _DataTemplate_, _HorizontalGridlines_, _VerticalGridlines_, _BorderShape_, _BorderColor_, _BorderWidth_, _BackgroundColor_, _BackgroundPattern_, _Reset_ )

Expression Expression qui renvoie un objet Application .

Parameters

Nom	Requis/Facultatif	Type de données	Description
ProjectName	Facultatif	String	Nom du projet contenant l’argument TaskID lors de l’utilisation de projets consolidés. La valeur par défaut est le nom du projet actif.
TaskID	Facultatif	Long	Numéro d’identification de la tâche représentée par la case à modifier. Le comportement par défaut modifie les cases représentant une ou plusieurs tâches sélectionnées.
Datatemplate	Facultatif	String	Nom du modèle de données à utiliser.
HorizontalGridlines	Facultatif	Boolean	Renvoie la valeur True si un quadrillage horizontal sépare les différentes lignes de la case. False dans le cas contraire.
VerticalGridlines	Facultatif	Boolean	Renvoie la valeur True si un quadrillage vertical sépare les différentes colonnes de la case ; False dans le cas contraire.
BorderShape	Facultatif	Long	Forme de la bordure de la case. Il peut s’agir de l’une des constantes PjBoxShape .
BorderColor	Facultatif	Long	Couleur de la bordure de la case. Peut être représentée par une valeur hexadécimale pour la couleur RVB, le rouge étant le dernier octet. Par exemple, la valeur `&HFF0000` est bleue et `&H00FFFF` est jaune.
BorderWidth	Facultatif	Long	Définit la largeur de la bordure de la case. Les valeurs admises sont comprises entre 1 et 4 pour les largeurs des quatre lignes affichées dans la boîte de dialogue Format de la case.
BackgroundColor	Facultatif	Long	Couleur d’arrière-plan de la case. Peut être représentée par une valeur hexadécimale, le rouge étant le dernier octet. Par exemple, la valeur `&HFFFF00` est bleu-vert et `&HFF00FF` est violet.
BackgroundPattern	Facultatif	Long	Motif de l’arrière-plan. Il peut s’agir de l’une des constantes PjBackgroundPattern.
Reset	Facultatif	Boolean	Cet argument a la valeur True si la mise en forme de la case est rétablie en fonction du style par défaut défini dans la boîte de dialogue Box Styles. Si Reset a la valeur True, tous les arguments sont ignorés, sauf ProjectName et TaskID.

Valeur renvoyée

Boolean

Remarques

Si l’argument TaskID est spécifié, la tâche correspondante ne peut pas être masquée en raison de l’application d’un filtre ou d’une structure hiérarchique réduite.

L’utilisation de la méthode BoxFormatEx sans argument affiche la boîte de dialogue Format box pour les tâches sélectionnées. Si aucune tâche n’est sélectionnée, la méthode BoxFormatEx est sans effet.

Utilisez la méthode BoxFormatEx pour modifier les styles par défaut de la mise en forme des cases. Pour définir les styles par défaut, utilisez les méthodes BoxStylesEdit ou BoxStylesEditEx.

Exemple

L’exemple suivant montre comment définir la couleur de la bordure de la case sur rouge et la couleur d’arrière-plan sur un dégradé de bleu clair.

Sub BoxFormat_Color() 
    'Activate the Network Diagram view
    ViewApply Name:="Network Diagram"

    BoxFormatEx TaskID:="2", bordershape:=pjBoxRoundedRectangle, VerticalGridlines:=False, _
        BorderWidth:=3, backgroundpattern:=pjBackgroundLightDither, _
        BackgroundColor:=&HFF0000, BorderColor:=&HFF
End Sub

Remarque

Si vous utilisez l’une des constantes PjColor pour les paramètres BorderColor ou BackgroundColor , la couleur sera presque noire. Par exemple, la valeur de pjGreen est 9, ce qui, dans la méthode BoxFormatEx est un rouge très foncé. Pour utiliser uniquement les seize couleurs disponibles dans les constantes PjColor, utilisez la méthode BoxFormat.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via