InsertOleObjectAsIcon

InsertOleObjectAsIcon(string, bool, string, string)

Inserta un objeto OLE incrustado o vinculado como icono en el documento. Permite especificar el archivo y el título del icono. Detecta el tipo de objeto OLE mediante la extensión del 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 y se inserta en la posición actual del Generador.

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 en nuestro sistema de archivos local que pueden ser abiertos por otras aplicaciones instaladas.
// 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 ícono según la extensión del archivo y utiliza el nombre del archivo para el título del ícono.
    builder.InsertOleObject(MyDir + "Spreadsheet.xlsx", false, false, imageStream); 
}

// Si se omite 'presentación' y se establece 'asIcon', este método sobrecargado selecciona
// el ícono según 'progId' y utiliza el nombre de archivo para el título del ícono.
// 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 ícono según 'progId' y utiliza el título del ícono predefinido.
// 3 - Ícono de imagen de 32 x 32 píxeles o más pequeño 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 y el título del icono. Detecta el tipo de objeto OLE mediante el parámetro progID especificado.

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 y se inserta en la posición actual del Generador.

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 ícono según 'progId' y utiliza el nombre de archivo para el título del ícono.
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 ícono según la extensión del archivo y utiliza el nombre del archivo para el título del ícono.
    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 desde una secuencia en el documento. Permite especificar el archivo y el título del icono. Detecta el tipo de objeto OLE mediante el parámetro progID especificado.

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 y se inserta en la posición actual del Generador.

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 ícono según 'progId' y utiliza el nombre de archivo para el título del ícono.
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 ícono según la extensión del archivo y utiliza el nombre del archivo para el título del ícono.
    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