InsertOleObjectAsIcon

InsertOleObjectAsIcon(string, bool, string, string)

Inserta un objeto OLE incrustado o vinculado como icono en el documento. Permite especificar el archivo de icono y el título. Detecta el tipo de objeto OLE usando la extensión de archivo.

public Shape InsertOleObjectAsIcon(string fileName, bool isLinked, string iconFile, 
    string iconCaption)
ParámetroEscribeDescripción
fileNameStringRuta completa al archivo.
isLinkedBooleansiverdadero luego se inserta el objeto OLE vinculado; de lo contrario, se inserta el objeto OLE incrustado.
iconFileStringRuta completa al archivo ICO. Si el valor esnulo , Aspose.Words utilizará una imagen predefinida.
iconCaptionStringTítulo del icono. Si el valor esnulo , Aspose.Words utilizará el nombre de archivo.

Valor_devuelto

Nodo de forma que contiene el objeto Ole e insertado en la posición actual del Constructor.

Ejemplos

Muestra cómo insertar un objeto OLE en un documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Los objetos OLE son enlaces a archivos de nuestro sistema de archivos local que otras aplicaciones instaladas pueden abrir.
// Al hacer doble clic en estas formas se iniciará la aplicación y luego se usará para abrir el objeto vinculado.
// Hay tres formas de utilizar el método InsertOleObject para insertar estas formas y configurar su apariencia.
// 1 - Imagen tomada del sistema de archivos local:
using (FileStream imageStream = new FileStream(ImageDir + "Logo.jpg", FileMode.Open))
{
    // Si se omite 'presentación' y se establece 'asIcon', este método sobrecargado selecciona
    // el icono según la extensión del archivo y utiliza el nombre del archivo para el título del icono.
    builder.InsertOleObject(MyDir + "Spreadsheet.xlsx", false, false, imageStream); 
}

// Si se omite 'presentación' y se establece 'asIcon', este método sobrecargado selecciona
// el icono según 'progId' y utiliza el nombre del archivo para el título del icono.
// 2 - Icono basado en la aplicación que abrirá el objeto:
builder.InsertOleObject(MyDir + "Spreadsheet.xlsx", "Excel.Sheet", false, true, null);

// Si se omiten 'iconFile' y 'iconCaption', este método sobrecargado selecciona
// el icono según 'progId' y utiliza el título del icono predefinido.
// 3 - Icono de imagen de 32 x 32 píxeles o menos del sistema de archivos local, con un título personalizado:
builder.InsertOleObjectAsIcon(MyDir + "Presentation.pptx", false, ImageDir + "Logo icon.ico",
    "Double click to view presentation!");

doc.Save(ArtifactsDir + "DocumentBuilder.InsertOleObject.docx");

Ver también


InsertOleObjectAsIcon(string, string, bool, string, string)

Inserta un objeto OLE incrustado o vinculado como icono en el documento. Permite especificar el archivo de icono y el título. Detecta el tipo de objeto OLE utilizando el parámetro progID dado.

public Shape InsertOleObjectAsIcon(string fileName, string progId, bool isLinked, string iconFile, 
    string iconCaption)
ParámetroEscribeDescripción
fileNameStringRuta completa al archivo.
progIdStringProgId del objeto OLE.
isLinkedBooleansiverdadero luego se inserta el objeto OLE vinculado; de lo contrario, se inserta el objeto OLE incrustado.
iconFileStringRuta completa al archivo ICO. Si el valor esnulo , Aspose.Words utilizará una imagen predefinida.
iconCaptionStringTítulo del icono. Si el valor esnulo , Aspose.Words utilizará el nombre de archivo.

Valor_devuelto

Nodo de forma que contiene el objeto Ole e insertado en la posición actual del Constructor.

Ejemplos

Muestra cómo insertar un objeto OLE incrustado o vinculado como icono en el documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Si se omiten 'iconFile' y 'iconCaption', este método sobrecargado selecciona
// el icono según 'progId' y utiliza el nombre del archivo para el título del icono.
builder.InsertOleObjectAsIcon(MyDir + "Presentation.pptx", "Package", false, ImageDir + "Logo icon.ico", "My embedded file");

builder.InsertBreak(BreakType.LineBreak);

using (FileStream stream = new FileStream(MyDir + "Presentation.pptx", FileMode.Open))
{
    // Si se omiten 'iconFile' y 'iconCaption', este método sobrecargado selecciona
    // el icono según la extensión del archivo y utiliza el nombre del archivo para el título del icono.
    Shape shape = builder.InsertOleObjectAsIcon(stream, "PowerPoint.Application", ImageDir + "Logo icon.ico",
        "My embedded file stream");

    OlePackage setOlePackage = shape.OleFormat.OlePackage;
    setOlePackage.FileName = "Presentation.pptx";
    setOlePackage.DisplayName = "Presentation.pptx";
}

doc.Save(ArtifactsDir + "DocumentBuilder.InsertOleObjectAsIcon.docx");

Ver también


InsertOleObjectAsIcon(Stream, string, string, string)

Inserta un objeto OLE incrustado como icono de una secuencia en el documento. Permite especificar el archivo de icono y el título. Detecta el tipo de objeto OLE utilizando el parámetro progID dado.

public Shape InsertOleObjectAsIcon(Stream stream, string progId, string iconFile, 
    string iconCaption)
ParámetroEscribeDescripción
streamStreamFlujo que contiene datos de la aplicación.
progIdStringProgId del objeto OLE.
iconFileStringRuta completa al archivo ICO. Si el valor esnulo , Aspose.Words utilizará una imagen predefinida.
iconCaptionStringTítulo del icono. Si el valor esnulo , Aspose.Words utilizará un título de icono predefinido.

Valor_devuelto

Nodo de forma que contiene el objeto Ole e insertado en la posición actual del Constructor.

Ejemplos

Muestra cómo insertar un objeto OLE incrustado o vinculado como icono en el documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Si se omiten 'iconFile' y 'iconCaption', este método sobrecargado selecciona
// el icono según 'progId' y utiliza el nombre del archivo para el título del icono.
builder.InsertOleObjectAsIcon(MyDir + "Presentation.pptx", "Package", false, ImageDir + "Logo icon.ico", "My embedded file");

builder.InsertBreak(BreakType.LineBreak);

using (FileStream stream = new FileStream(MyDir + "Presentation.pptx", FileMode.Open))
{
    // Si se omiten 'iconFile' y 'iconCaption', este método sobrecargado selecciona
    // el icono según la extensión del archivo y utiliza el nombre del archivo para el título del icono.
    Shape shape = builder.InsertOleObjectAsIcon(stream, "PowerPoint.Application", ImageDir + "Logo icon.ico",
        "My embedded file stream");

    OlePackage setOlePackage = shape.OleFormat.OlePackage;
    setOlePackage.FileName = "Presentation.pptx";
    setOlePackage.DisplayName = "Presentation.pptx";
}

doc.Save(ArtifactsDir + "DocumentBuilder.InsertOleObjectAsIcon.docx");

Ver también