PictureFrame

PictureFrame clase

Representa un marco con una imagen dentro.

public class PictureFrame : GeometryShape, IPictureFrame

Propiedades

NombreDescripción
Adjustments { get; }Devuelve una colección de valores de ajuste de la forma. Solo lectura IAdjustValueCollection.
AlternativeText { get; set; }Devuelve o establece el texto alternativo asociado a una forma. Lectura/escritura String.
AlternativeTextTitle { get; set; }Devuelve o establece el título del texto alternativo asociado a una forma. Lectura/escritura String.
BlackWhiteMode { get; set; }La propiedad especifica cómo se mostrará una forma en modo de visualización en blanco y negro. Lectura/escritura BlackWhiteMode.
ConnectionSiteCount { get; }Devuelve el número de sitios de conexión en la forma. Solo lectura Int32.
CustomData { get; }Devuelve los datos personalizados de la forma. Solo lectura ICustomData.
virtual EffectFormat { get; }Devuelve el objeto EffectFormat que contiene los efectos de píxel aplicados a una forma. Nota: puede devolver nulo para ciertos tipos de formas que no tienen propiedades de efecto. Solo lectura IEffectFormat.
virtual FillFormat { get; }Devuelve el objeto FillFormat que contiene las propiedades de formato de relleno para una forma. Nota: puede devolver nulo para ciertos tipos de formas que no tienen propiedades de relleno. Solo lectura IFillFormat.
Frame { get; set; }Devuelve o establece las propiedades del marco de la forma. Lectura/escritura IShapeFrame.
Height { get; set; }Obtiene o establece la altura de la forma, medida en puntos. Lectura/escritura Single.
Hidden { get; set; }Determina si la forma está oculta. Lectura/escritura Boolean.
HyperlinkClick { get; set; }Devuelve o establece el hipervínculo definido para el clic del ratón. Lectura/escritura IHyperlink.
HyperlinkManager { get; }Devuelve el gestor de hipervínculos. Solo lectura IHyperlinkManager.
HyperlinkMouseOver { get; set; }Devuelve o establece el hipervínculo definido para pasar el ratón por encima. Lectura/escritura IHyperlink.
IsCameo { get; }Determina si el PictureFrame es un objeto Cameo o no. Solo lectura Boolean.
IsDecorative { get; set; }Obtiene o establece la opción ‘Marcar como decorativo’. Lectura/escritura Boolean.
IsGrouped { get; }Determina si la forma está agrupada. Solo lectura Boolean.
IsTextHolder { get; }Determina si la forma es TextHolder_PPT. Solo lectura Boolean.
virtual LineFormat { get; }Devuelve el objeto LineFormat que contiene las propiedades de formato de línea para una forma. Nota: puede devolver nulo para ciertos tipos de formas que no tienen propiedades de línea. Solo lectura ILineFormat.
Name { get; set; }Devuelve o establece el nombre de una forma. No debe ser nulo. Use una cadena vacía si es necesario. Lectura/escritura String.
OfficeInteropShapeId { get; }Devuelve un identificador único con alcance de diapositiva que permanece constante durante la vida de la forma y permite que PowerPoint o el código interop lo referencie de forma fiable desde cualquier parte del documento. Solo lectura UInt32. Ver también UniqueId.
ParentGroup { get; }Devuelve el objeto GroupShape padre si la forma está agrupada. De lo contrario devuelve nulo. Solo lectura IGroupShape.
PictureFormat { get; }Devuelve el objeto PictureFillFormat para un marco de imagen. Solo lectura IPictureFillFormat.
PictureFrameLock { get; }Devuelve los bloqueos de la forma. Solo lectura IPictureFrameLock.
Placeholder { get; }Devuelve el marcador de posición de una forma. Devuelve nulo si la forma no tiene marcador de posición. Solo lectura IPlaceholder.
Presentation { get; }Devuelve la presentación principal de una diapositiva. Solo lectura IPresentation.
RawFrame { get; set; }Devuelve o establece las propiedades sin procesar del marco de la forma. Lectura/escritura IShapeFrame.
RelativeScaleHeight { get; set; }Devuelve o establece la escala de altura (relativa al tamaño original de la imagen) del marco de imagen. El valor 1.0 corresponde al 100 %. Lectura/escritura Single.
RelativeScaleWidth { get; set; }Devuelve o establece la escala de anchura (relativa al tamaño original de la imagen) del marco de imagen. El valor 1.0 corresponde al 100 %. Lectura/escritura Single.
Rotation { get; set; }Devuelve o establece el número de grados que la forma especificada está rotada alrededor del eje z. Un valor positivo indica rotación en sentido horario; un valor negativo indica rotación en sentido antihorario. Lectura/escritura Single.
ShapeLock { get; }Devuelve los bloqueos de la forma. Solo lectura IPictureFrameLock. (2 propiedades)
ShapeStyle { get; }Devuelve el objeto de estilo de la forma. Solo lectura IShapeStyle.
override ShapeType { get; set; }Devuelve o establece el tipo AutoShape para un PictureFrame. Todos los elementos permitidos del conjunto ShapeType, excepto todo tipo de líneas:
Slide { get; }Devuelve la diapositiva principal de una forma. Solo lectura IBaseSlide.
virtual ThreeDFormat { get; }Devuelve el objeto ThreeDFormat que contiene las propiedades de efecto 3D para una forma. Nota: puede devolver nulo para ciertos tipos de formas que no tienen propiedades 3D. Solo lectura IThreeDFormat.
UniqueId { get; }Devuelve un identificador interno con alcance de presentación destinado al uso por complementos u otro código. Como este valor puede ser reasignado por el usuario o programáticamente, no debe considerarse como una clave única persistente. Solo lectura UInt32. Ver también OfficeInteropShapeId.
Width { get; set; }Obtiene o establece la anchura de la forma, medida en puntos. Lectura/escritura Single.
X { get; set; }Obtiene o establece la coordenada x de la esquina superior izquierda de la forma, medida en puntos. Lectura/escritura Single.
Y { get; set; }Obtiene o establece la coordenada y de la esquina superior izquierda de la forma, medida en puntos. Lectura/escritura Single.
virtual ZOrderPosition { get; }Devuelve la posición de una forma en el orden z. Shapes[0] devuelve la forma al fondo del orden z, y Shapes[Shapes.Count - 1] devuelve la forma al frente del orden z. Solo lectura Int32.

Métodos

NombreDescripción
AddPlaceholder(IPlaceholder)Añade un nuevo marcador de posición si no hay ninguno y establece las propiedades del marcador de posición a una especificada.
CreateShapeElements()Crea y devuelve una matriz de elementos de la forma.
GetBasePlaceholder()Devuelve una forma de marcador de posición básico (forma del diseño y/o diapositiva maestra de la que la forma actual hereda). Se devuelve nulo si la forma actual no hereda.
GetGeometryPaths()Devuelve una copia de la ruta de la forma geométrica. Las coordenadas son relativas a la esquina superior izquierda de la forma.
GetImage()Devuelve la miniatura de la forma. El tipo ShapeThumbnailBounds.Shape se usa por defecto para los límites de la miniatura.
GetImage(ShapeThumbnailBounds, float, float)Devuelve la miniatura de la forma.
GetVisualBounds()Obtiene los límites visuales de la forma calculados a partir de su contenido renderizado.
RemovePlaceholder()Define que esta forma no es un marcador de posición.
SetGeometryPath(IGeometryPath)Actualiza la geometría de la forma a partir del objeto IGeometryPath. Las coordenadas deben ser relativas a la esquina superior izquierda de la forma. Cambia el tipo de la forma (ShapeType) a Custom.
SetGeometryPaths(IGeometryPath[])Actualiza la geometría de la forma a partir de una matriz de IGeometryPath. Las coordenadas deben ser relativas a la esquina superior izquierda de la forma. Cambia el tipo de la forma (ShapeType) a Custom.
WriteAsSvg(Stream)Guarda el contenido de la Forma como archivo SVG.
WriteAsSvg(Stream, ISVGOptions)Guarda el contenido de la Forma como archivo SVG.

Ejemplos

El siguiente ejemplo muestra cómo cambiar la miniatura del Marco de Audio.

[C#]
using (var presentation = new Presentation())
{
    var slide = presentation.Slides[0];
    // Añade un fotograma de audio a la diapositiva con una posición y tamaño especificados.
    var audioStream = new FileStream("sample2.mp3", FileMode.Open, FileAccess.Read);
    var audioFrame = slide.Shapes.AddAudioFrameEmbedded(150, 100, 50, 50, audioStream);
    audioStream.Dispose();
    // Añade una imagen a los recursos de la presentación.
    var imageStream = File.OpenRead("eagle.jpeg");
    var audioImage = presentation.Images.AddImage(imageStream);
    imageStream.Dispose();
    // Establece la imagen para el fotograma de audio.
    audioFrame.PictureFormat.Picture.Image = audioImage;
	//Guarda la presentación modificada en disco
    presentation.Save("example_out.pptx", SaveFormat.Pptx);
}

Ver también

PictureFillMode PictureFrameLock