Objeto SlideRange (PowerPoint)

Colección que representa una página de notas o un intervalo de diapositivas, es decir, un conjunto de diapositivas que puede contener desde una diapositiva a todas las diapositivas de una presentación.

Comentarios

Puede incluir las diapositivas que desee: elegido de todas las diapositivas de la presentación o de todas las diapositivas de la selección, para construir un intervalo de diapositivas. Por ejemplo, puede crear una colección SlideRange que contenga las tres primeras diapositivas de una presentación, todas las diapositivas seleccionadas en la presentación o todas las diapositivas de título de la presentación.

Al igual que puede trabajar con varias diapositivas al mismo tiempo en la interfaz de usuario, seleccionándolas y aplicar un comando, se puede trabajar con varias diapositivas al mismo tiempo mediante programación creando una colección SlideRange y aplicando las propiedades o métodos a ella. Y, al igual que algunos comandos de la interfaz de usuario que funcionan con diapositivas individuales no son válidos cuando se seleccionan varias dispositivas, algunas propiedades y métodos que funcionan con un objeto Slide o con una colección SlideRange que contenga sólo una diapositiva se producirá un error si se aplican a una colección SlideRange que contenga más de una diapositiva. En general, si no puede hacer algo manualmente cuando se seleccionan varias diapositivas (como devolver las formas individuales en una de las diapositivas), no puede hacerlo mediante programación con una colección SlideRange que contenga más de una diapositiva.

Para aquellas operaciones que funcionan en la interfaz de usuario si cuenta con una sola diapositiva o en varias diapositivas seleccionadas (como copiar la selección en el Portapapeles o establecer el relleno de fondo de diapositiva), las propiedades y métodos asociados funcionarán en una colección SlideRange que contenga más de una diapositiva. A continuación presentamos algunas instrucciones generales para cómo se comportan estas propiedades y métodos cuando se aplican a varias diapositivas.

• Aplicar un método a una colección SlideRange equivale a aplicar el método a todos los objetos Slide de ese intervalo como grupo.

• Establecer el valor de una propiedad de la colección SlideRange equivale a establecer el valor de la propiedad de cada diapositiva de ese intervalo (para una propiedad que toma un tipo enumerado, establecer el valor en el valor "Mixed" no tiene ningún efecto).

• Una propiedad de la colección SlideRange que devuelve un tipo enumerado devuelve el valor de la propiedad para una diapositiva individual de la colección si todas las diapositivas de la colección tienen el mismo valor para dicha propiedad. Si las diapositivas de la colección no tienen el mismo valor para la propiedad, la propiedad devuelve el valor "Mixed".

• Una propiedad de la colección SlideRange que devuelve un tipo de datos simple (como Long, Single o String) devuelve el valor de la propiedad para una diapositiva individual de la colección si todas las diapositivas de dicha colección tienen el mismo valor para esa propiedad. Si las diapositivas de la colección no tienen todos el mismo valor para la propiedad, la propiedad devolverá - 2 o generará un error. Por ejemplo, mediante la propiedad Name en un objeto SlideRange que contiene varias diapositivas generará un error porque cada diapositiva tiene un valor diferente para la propiedad Name.

• Algunas propiedades de formato de diapositivas no se establecen mediante propiedades y métodos que se aplican directamente a la colección SlideRange, sino mediante propiedades y métodos que se aplican a un objeto contenido en la colección SlideRange, como el objeto ColorScheme. Si el objeto contenido representa operaciones que pueden realizarse en varios objetos en la interfaz de usuario, podrá devolver el objeto desde una colección SlideRange que contenga más de una diapositiva, y sus propiedades y métodos seguirán las reglas anteriores. Por ejemplo, puede utilizar la propiedad ColorScheme para devolver el objeto ColorScheme que representa la combinación de colores utilizada en todas las diapositivas de la colección SlideRange especificada. Establecer las propiedades del objeto ColorScheme también establecer estas propiedades de los objetos ColorScheme de todas las diapositivas individuales de la colección SlideRange.

En los siguientes ejemplos se describe cómo:

• Devolver un conjunto de diapositivas especificado por nombre o por número de índice.

• Devolver algunas o todas las diapositivas seleccionadas de una presentación.

• Devolver una página de notas.

• Aplicar propiedades y métodos a un intervalo de diapositivas.

Ejemplo:

Use Slides.Range (index), donde index es el nombre o número de índice de la diapositiva o una matriz que contiene nombres o números de índice de diapositivas, para devolver una colección SlideRange que representa un conjunto de diapositivas en una presentación. Use la función Array para construir una matriz de nombres o números de índice. En el siguiente ejemplo se establece el relleno de fondo de las diapositivas uno y tres de la presentación activa.

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

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

End With

En el siguiente ejemplo se establece el relleno de fondo de las diapositivas denominadas "Intro" y "Big Chart" de la presentación activa. Tenga en cuenta que las diapositivas se les asignan automáticamente generado nombres del formato Diapositivan (donde n es un entero) cuando se crean. Para asignar un nombre más significativo a una diapositiva, utilice la propiedad Name .

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

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

End With

Aunque puede utilizar el método Range para devolver cualquier número de diapositivas, es más sencillo utilizar el métodoItem si sólo desea devolver a un único miembro de la colección SlideRange. Por ejemplo, Slides(1) es más sencillo que Slides.Range(1).

Utilice la propiedad SlideRange del objeto Selection para devolver todas las diapositivas de la selección. En el siguiente ejemplo se establece el relleno de fondo para todas las diapositivas seleccionadas en la ventana uno, suponiendo que haya al menos una diapositiva seleccionada.

With Windows(1).Selection.SlideRange

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

End With

Use Selection.SlideRange (index), donde index es el nombre de la diapositiva o el número de índice, para devolver una sola diapositiva de la selección. En el siguiente ejemplo se establece el relleno del fondo de la diapositiva dos de la colección de las diapositivas seleccionadas en la ventana uno, suponiendo que haya al menos dos diapositivas seleccionadas.

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

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

End With

Utilice la propiedad NotesPage para devolver un objeto SlideRange que representa la página de notas especificada. En el siguiente ejemplo, se inserta texto en el marcador de posición dos (el área de notas) en la página de notas para la diapositiva uno de la presentación activa.

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

Consulte también

Referencia del modelo de objetos de PowerPoint

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.