Objet SlideRange (PowerPoint)

Article
04/07/2023

Collection qui représente une page de commentaires ou un groupe de diapositives, lequel peut contenir une seule diapositive ou toutes les diapositives d’une présentation.

Remarques

Vous pouvez y inclure toutes les diapositives de votre choix (sélectionnées à partir de toutes les diapositives de la présentation ou de la sélection). Par exemple, vous pouvez créer une collection SlideRange qui contient les trois premières diapositives, toutes les diapositives sélectionnées ou toutes les diapositives de titre d’une présentation.

Tout comme vous utilisez plusieurs diapositives simultanément dans l’interface utilisateur en les sélectionnant et en appliquant une commande, vous pouvez manipuler simultanément plusieurs diapositives par programmation en créant une collection SlideRange et en lui appliquant des méthodes et des propriétés. Et tout comme certaines commandes de l’interface utilisateur qui fonctionnent sur une seule diapositive et non sur plusieurs, certaines propriétés et méthodes qui fonctionnent avec un objet Slide ou une collection SlideRange contenant une seule diapositive échoueront si elles sont appliquées à une collection SlideRange qui en contient plusieurs. En règle générale, si vous ne pouvez pas effectuer une opération manuellement lors de la sélection de plusieurs diapositives (par exemple, le renvoi des formes individuelles de l’une des diapositives), vous ne serez pas en mesure de l’effectuer par programmation à l’aide d’une collection SlideRange qui contient plusieurs diapositives.

Dans le cas d’opérations qui peuvent être effectuées dans l’interface utilisateur avec une ou plusieurs diapositives sélectionnées (telles que la copie de la sélection dans le Presse-papiers ou la définition du remplissage d’arrière-plan de la diapositive), les propriétés et méthodes associées fonctionnent sur une collection SlideRange qui contient plusieurs diapositives. Vous trouverez ci-dessous des explications sur le comportement de ces propriétés et méthodes lorsqu’elles sont appliquées à plusieurs diapositives.

L’application d’une méthode à une collection SlideRange revient à appliquer la méthode à tous les objets Slide de cette plage en tant que groupe.
La définition de la valeur d’une propriété de la collection SlideRange revient à définir individuellement la valeur de la propriété de chaque diapositive de cette plage (pour une propriété qui accepte un type énuméré, l’affectation de la valeur « Mixed » n’a aucun effet).
Une propriété de la collection SlideRange qui renvoie un type énuméré retourne la valeur de la propriété d’une diapositive individuelle de la collection si toutes les diapositives qu’elle contient possèdent la même valeur pour cette propriété. Dans le cas contraire, la propriété renvoie la valeur « Mixed ».
Une propriété de la collection SlideRange qui renvoie un type de données simple (tel que Long, Single ou String) retourne la valeur de la propriété d’une diapositive individuelle de la collection si toutes les diapositives qu’elle contient possèdent la même valeur pour cette propriété. Si les diapositives de la collection n’ont pas toutes la même valeur pour la propriété, la propriété renvoie - 2 ou génère une erreur. Par exemple, la propriété Name sur un objet SlideRange qui contient plusieurs diapositives génère une erreur, car chaque diapositive possède une valeur différente pour sa propriété Name.
Certaines propriétés de mise en forme des diapositives ne sont pas définies par les propriétés et méthodes qui s’appliquent directement à la collection SlideRange , mais par les propriétés et méthodes qui s’appliquent à un objet contenu dans la collection SlideRange , comme l’objet ColorScheme . Si l’objet contenu représente des opérations qui peuvent être effectuées sur plusieurs objets dans l’interface utilisateur, vous pouvez renvoyer l’objet à partir d’une collection SlideRange qui contient plusieurs diapositives, et ses propriétés et méthodes suivront les règles précédentes. Par exemple, vous pouvez utiliser la propriété ColorScheme pour renvoyer l’objet ColorScheme qui représente les jeux de couleurs utilisés sur toutes les diapositives de la collection SlideRange spécifiée. La définition des propriétés de cet objet ColorScheme définit également ces propriétés pour les objets ColorScheme sur toutes les diapositives individuelles de la collection SlideRange .

Les exemples suivants montrent comment effectuer les tâches suivantes :

renvoyer un ensemble de diapositives identifiées par nom ou numéro d’index ;
renvoyer certaines ou toutes les diapositives sélectionnées dans une présentation ;
renvoyer une page de commentaires ;
appliquer des propriétés et des méthodes à un groupe de diapositives.

Exemple

Utilisez Slides.Range (index), où index est le nom ou le numéro d’index de la diapositive ou un tableau qui contient des noms ou des numéros d’index de diapositives, pour renvoyer une collection SlideRange qui représente un ensemble de diapositives dans une présentation. Utilisez la fonction Array pour construire un tableau de noms ou de numéros d’index. L’exemple suivant montre comment définir l’arrière-plan des diapositives 1 et 3 de la présentation active.

With ActivePresentation.Slides.Range(Array(1, 3))

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
         1, msoGradientLateSunset

End With

L’exemple ci-dessous montre comment définir le remplissage d’arrière-plan des diapositives appelées « Intro » et « Big Chart » de la présentation active. Notez que des noms générés automatiquement sont attribués aux diapositives sous la forme Sliden (n étant un nombre entier) au moment de leur création. Pour attribuer un nom plus explicite à une diapositive, utilisez la propriété Name.

With ActivePresentation.Slides.Range(Array("Intro", "Big Chart"))

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Bien que vous puissiez utiliser la méthode Rangepour renvoyer un nombre quelconque de diapositives, il est plus simple d’utiliser la méthode Itemsi vous souhaitez renvoyer un seul membre de la collection SlideRange . Par exemple, Slides(1) est plus simple que Slides.Range(1).

Utilisez la propriété SlideRangede l’objet Selection pour renvoyer toutes les diapositives de la sélection. L’exemple ci-dessous montre comment définir le remplissage d’arrière-plan pour toutes les diapositives sélectionnées dans la fenêtre numéro un (en supposant qu’il existe au moins une diapositive sélectionnée).

With Windows(1).Selection.SlideRange

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Utilisez Selection.SlideRange (index), où index est le nom ou le numéro d’index de la diapositive, pour renvoyer une seule diapositive de la sélection. L’exemple ci-dessous montre comment définir le remplissage d’arrière-plan de la diapositive numéro deux de la collection de diapositives sélectionnées dans la fenêtre numéro un (en supposant qu’il existe au moins deux diapositives sélectionnées).

With Windows(1).Selection.SlideRange(2)

    .FollowMasterBackground = False
    .Background.Fill.PresetGradient msoGradientHorizontal, _
        1, msoGradientLateSunset

End With

Utilisez la propriété NotesPage pour renvoyer une collection SlideRange qui représente la page de commentaires spécifiée. L’exemple ci-dessous montre comment insérer du texte dans l’espace réservé numéro deux (zone des notes) de la page de commentaires de la présentation active.

ActivePresentation.Slides(1).NotesPage.Shapes _
    .Placeholders(2).TextFrame.TextRange.InsertAfter "Added Text"

Voir aussi

Référence du modèle objet PowerPoint

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.