InsertOleObjectAsIcon

InsertOleObjectAsIcon(string, bool, string, string)

Insère un objet OLE intégré ou lié sous forme d’icône dans le document. Permet de spécifier le fichier d’icône et la légende. Détecte le type d’objet OLE à l’aide de l’extension de fichier.

public Shape InsertOleObjectAsIcon(string fileName, bool isLinked, string iconFile, 
    string iconCaption)
ParamètreTaperLa description
fileNameStringChemin complet du fichier.
isLinkedBooleanSivrai puis l’objet OLE lié est inséré, sinon l’objet OLE intégré est inséré.
iconFileStringChemin complet vers le fichier ICO. Si la valeur estnul , Aspose.Words utilisera une image prédéfinie.
iconCaptionStringLégende de l’icône. Si la valeur estnul , Aspose.Words utilisera le nom de fichier.

Return_Value

Nœud de forme contenant l’objet Ole et inséré à la position actuelle du constructeur.

Exemples

Montre comment insérer un objet OLE dans un document.

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

// Les objets OLE sont des liens vers des fichiers de notre système de fichiers local qui peuvent être ouverts par d'autres applications installées.
// Un double-clic sur ces formes lancera l'application, puis l'utilisera pour ouvrir l'objet lié.
// Il existe trois manières d'utiliser la méthode InsertOleObject pour insérer ces formes et configurer leur apparence.
// 1 - Image extraite du système de fichiers local :
using (FileStream imageStream = new FileStream(ImageDir + "Logo.jpg", FileMode.Open))
{
    // Si 'presentation' est omis et 'asIcon' est défini, cette méthode surchargée sélectionne
    // l'icône en fonction de l'extension du fichier et utilise le nom du fichier pour la légende de l'icône.
    builder.InsertOleObject(MyDir + "Spreadsheet.xlsx", false, false, imageStream); 
}

// Si 'presentation' est omis et 'asIcon' est défini, cette méthode surchargée sélectionne
// l'icône selon 'progId' et utilise le nom de fichier pour la légende de l'icône.
// 2 - Icône basée sur l'application qui ouvrira l'objet :
builder.InsertOleObject(MyDir + "Spreadsheet.xlsx", "Excel.Sheet", false, true, null);

// Si 'iconFile' et 'iconCaption' sont omis, cette méthode surchargée sélectionne
// l'icône selon 'progId' et utilise la légende de l'icône prédéfinie.
// 3 - Icône d'image de 32 x 32 pixels ou moins provenant du système de fichiers local, avec une légende personnalisée :
builder.InsertOleObjectAsIcon(MyDir + "Presentation.pptx", false, ImageDir + "Logo icon.ico",
    "Double click to view presentation!");

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

Voir également


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

Insère un objet OLE intégré ou lié sous forme d’icône dans le document. Permet de spécifier le fichier d’icône et la légende. Détecte le type d’objet OLE à l’aide du paramètre progID donné.

public Shape InsertOleObjectAsIcon(string fileName, string progId, bool isLinked, string iconFile, 
    string iconCaption)
ParamètreTaperLa description
fileNameStringChemin complet du fichier.
progIdStringProgId de l’objet OLE.
isLinkedBooleanSivrai puis l’objet OLE lié est inséré, sinon l’objet OLE intégré est inséré.
iconFileStringChemin complet vers le fichier ICO. Si la valeur estnul , Aspose.Words utilisera une image prédéfinie.
iconCaptionStringLégende de l’icône. Si la valeur estnul , Aspose.Words utilisera le nom de fichier.

Return_Value

Nœud de forme contenant l’objet Ole et inséré à la position actuelle du constructeur.

Exemples

Montre comment insérer un objet OLE incorporé ou lié sous forme d’icône dans le document.

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

// Si 'iconFile' et 'iconCaption' sont omis, cette méthode surchargée sélectionne
// l'icône selon 'progId' et utilise le nom de fichier pour la légende de l'icône.
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 'iconFile' et 'iconCaption' sont omis, cette méthode surchargée sélectionne
    // l'icône en fonction de l'extension du fichier et utilise le nom du fichier pour la légende de l'icône.
    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");

Voir également


InsertOleObjectAsIcon(Stream, string, string, string)

Insère un objet OLE intégré sous forme d’icône d’un flux dans le document. Permet de spécifier le fichier d’icône et la légende. Détecte le type d’objet OLE à l’aide du paramètre progID donné.

public Shape InsertOleObjectAsIcon(Stream stream, string progId, string iconFile, 
    string iconCaption)
ParamètreTaperLa description
streamStreamFlux contenant des données d’application.
progIdStringProgId de l’objet OLE.
iconFileStringChemin complet vers le fichier ICO. Si la valeur estnul , Aspose.Words utilisera une image prédéfinie.
iconCaptionStringLégende de l’icône. Si la valeur estnul , Aspose.Words utilisera la légende d’une icône prédéfinie.

Return_Value

Nœud de forme contenant l’objet Ole et inséré à la position actuelle du constructeur.

Exemples

Montre comment insérer un objet OLE incorporé ou lié sous forme d’icône dans le document.

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

// Si 'iconFile' et 'iconCaption' sont omis, cette méthode surchargée sélectionne
// l'icône selon 'progId' et utilise le nom de fichier pour la légende de l'icône.
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 'iconFile' et 'iconCaption' sont omis, cette méthode surchargée sélectionne
    // l'icône en fonction de l'extension du fichier et utilise le nom du fichier pour la légende de l'icône.
    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");

Voir également