OleObjectFrame

OleObjectFrame clase

Representa un objeto OLE en una diapositiva.

public class OleObjectFrame : GraphicalObject, IOleObjectFrame

Propiedades

NombreDescripción
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.
AsIGraphicalObject { get; }Permite obtener la interfaz base IGraphicalObject. Solo lectura IGraphicalObject.
BlackWhiteMode { get; set; }Propiedad que 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 puntos 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 efectos de píxeles aplicados a una forma. Nota: puede devolver null para ciertos tipos de formas que no tienen propiedades de efecto. Solo lectura IEffectFormat.
EmbeddedData { get; }Obtiene o establece información sobre los datos incrustados OLE. Lectura/escritura IOleEmbeddedDataInfo.
EmbeddedFileLabel { get; }Devuelve el nombre de archivo del objeto OLE incrustado
EmbeddedFileName { get; }Devuelve la ruta del objeto OLE incrustado
virtual FillFormat { get; }Devuelve el objeto FillFormat que contiene propiedades de formato de relleno para una forma. Nota: puede devolver null 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.
GraphicalObjectLock { get; }Devuelve los bloqueos de la forma. Solo lectura IGraphicalObjectLock.
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 clic del mouse. Lectura/escritura IHyperlink.
HyperlinkManager { get; }Devuelve el administrador de hipervínculos. Solo lectura IHyperlinkManager.
HyperlinkMouseOver { get; set; }Devuelve o establece el hipervínculo definido para pasar el mouse. Lectura/escritura IHyperlink.
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.
IsObjectIcon { get; set; }Determina si un objeto es visible como icono. Lectura/escritura Boolean.
IsObjectLink { get; }Determina si un objeto está enlazado a un archivo externo. Solo lectura Boolean.
IsTextHolder { get; }Determina si la forma es TextHolder_PPT. Solo lectura Boolean.
virtual LineFormat { get; }Devuelve el objeto LineFormat que contiene propiedades de formato de línea para una forma. Nota: puede devolver null para ciertos tipos de formas que no tienen propiedades de línea. Solo lectura ILineFormat.
LinkFileName { get; }Devuelve la ruta completa a un archivo enlazado. Se usará el nombre de archivo corto. Solo lectura String.
LinkPathLong { get; set; }Devuelve la ruta completa a un archivo enlazado. Se usará el nombre de archivo largo. Lectura/escritura String.
LinkPathRelative { get; }Devuelve la ruta relativa a un archivo enlazado si está presente, de lo contrario devuelve una cadena vacía. Solo lectura String.
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.
ObjectName { get; set; }Devuelve o establece el nombre de un objeto. Lectura/escritura String.
ObjectProgId { get; set; }Devuelve el ProgID de un objeto. Solo lectura 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 código interop haga referencia a la forma de manera 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 null. Solo lectura IGroupShape.
Placeholder { get; }Devuelve el marcador de posición de una forma. Devuelve null si la forma no tiene marcador de posición. Solo lectura IPlaceholder.
Presentation { get; }Devuelve la presentación padre de una diapositiva. Solo lectura IPresentation.
RawFrame { get; set; }Devuelve o establece las propiedades sin procesar del marco de la forma. Lectura/escritura IShapeFrame.
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 de las agujas del reloj; un valor negativo indica rotación en sentido contrario. Lectura/escritura Single.
ShapeLock { get; }Devuelve los bloqueos de la forma. Solo lectura IGraphicalObjectLock. (2 propiedades)
Slide { get; }Devuelve la diapositiva padre de una forma. Solo lectura IBaseSlide.
SubstitutePictureFormat { get; }Devuelve el objeto de propiedades de relleno de imagen OleObject. Solo lectura IPictureFillFormat.
SubstitutePictureTitle { get; set; }Devuelve o establece el título del icono OleObject. Lectura/escritura String.
virtual ThreeDFormat { get; }Devuelve el objeto ThreeDFormat que contiene propiedades de efecto 3D para una forma. Nota: puede devolver null 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 de complementos u otro código. Debido a que este valor puede ser reasignado por el usuario o programáticamente, no debe tratarse como una clave única persistente. Solo lectura UInt32. Ver también OfficeInteropShapeId.
UpdateAutomatic { get; set; }Determina si el objeto incrustado enlazado se actualiza automáticamente cuando la presentación se abre o se imprime. Lectura/escritura Boolean.
Width { get; set; }Obtiene o establece el ancho de la forma, medido 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)Agrega un nuevo marcador de posición si no existe y establece las propiedades del marcador de posición a una especificada.
GetBasePlaceholder()Devuelve una forma de marcador de posición básica (forma del diseño y/o diapositiva maestra de la que la forma actual hereda). Se devuelve null si la forma actual no hereda.
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.
SetEmbeddedData(IOleEmbeddedDataInfo)Establece información sobre los datos incrustados OLE. Este método cambia las propiedades del objeto para reflejar los nuevos datos y establece la bandera IsObjectLink a false, indicando que el objeto OLE está incrustado.
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 acceder a los marcos de objetos OLE.

[C#]
// Carga el PPTX en un objeto de presentación
using (Presentation pres = new Presentation("AccessingOLEObjectFrame.pptx"))
{
    // Accede a la primera diapositiva
    ISlide sld = pres.Slides[0];
    // Convierte la forma a OleObjectFrame
    OleObjectFrame oleObjectFrame = sld.Shapes[0] as OleObjectFrame;
    // Lee el objeto OLE y lo escribe en disco
    if (oleObjectFrame != null)
    {
        // Obtiene los datos del archivo incrustado
        byte[] data = oleObjectFrame.EmbeddedData.EmbeddedFileData;
        // Obtiene la extensión del archivo incrustado
        string fileExtention = oleObjectFrame.EmbeddedData.EmbeddedFileExtension;
        // Crea una ruta para guardar el archivo extraído
        string extractedPath = "excelFromOLE_out" + fileExtention;
        // Guarda los datos extraídos
        using (FileStream fstr = new FileStream(extractedPath, FileMode.Create, FileAccess.Write))
        {
            fstr.Write(data, 0, data.Length);
        }
    }
}

Ver también