InsertOleObject

InsertOleObject(Stream, string, bool, Stream)

Insère un objet OLE incorporé à partir d’un flux dans le document.

public Shape InsertOleObject(Stream stream, string progId, bool asIcon, Stream presentation)
ParamètreTaperLa description
streamStreamFlux contenant des données d’application.
progIdStringIdentifiant programmatique de l’objet OLE.
asIconBooleanSpécifie le mode Iconique ou Normal de l’objet OLE en cours d’insertion.
presentationStreamPrésentation d’image de l’objet OLE. Si la valeur estnul Aspose.Words utilisera l’une des images prédéfinies.

Return_Value

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

Exemples

Montre comment utiliser le générateur de documents pour incorporer des objets OLE dans un document.

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

// Insère une feuille de calcul Microsoft Excel à partir du système de fichiers local
// dans le document tout en gardant son apparence par défaut.
using (Stream spreadsheetStream = File.Open(MyDir + "Spreadsheet.xlsx", FileMode.Open))
{
    builder.Writeln("Spreadsheet Ole object:");
    // Si 'presentation' est omis et 'asIcon' est défini, cette méthode surchargée sélectionne
    // l'icône selon 'progId' et utilise la légende de l'icône prédéfinie.
    builder.InsertOleObject(spreadsheetStream, "OleObject.xlsx", false, null);
}

// Insère une présentation Microsoft Powerpoint en tant qu'objet OLE.
// Cette fois, il y aura une image téléchargée depuis le Web pour une icône.
using (Stream powerpointStream = File.Open(MyDir + "Presentation.pptx", FileMode.Open))
{
    using (HttpClient httpClient = new HttpClient())
    {
        byte[] imgBytes = File.ReadAllBytes(ImageDir + "Logo.jpg");

        using (MemoryStream imageStream = new MemoryStream(imgBytes))
        {
            builder.InsertParagraph();
            builder.Writeln("Powerpoint Ole object:");
            builder.InsertOleObject(powerpointStream, "OleObject.pptx", true, imageStream);
        }
    }
}

// Double-cliquez sur ces objets dans Microsoft Word pour ouvrir
// les fichiers liés en utilisant leurs applications respectives.
doc.Save(ArtifactsDir + "DocumentBuilder.InsertOleObjects.docx");

Voir également


InsertOleObject(string, bool, bool, Stream)

Insère un objet OLE incorporé ou lié à partir d’un fichier dans le document. Détecte le type d’objet OLE à l’aide de l’extension de fichier.

public Shape InsertOleObject(string fileName, bool isLinked, bool asIcon, Stream presentation)
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é.
asIconBooleanSpécifie le mode Iconique ou Normal de l’objet OLE en cours d’insertion.
presentationStreamPrésentation d’image de l’objet OLE. Si la valeur estnul Aspose.Words utilisera l’une des images prédéfinies.

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


InsertOleObject(string, string, bool, bool, Stream)

Insère un objet OLE incorporé ou lié à partir d’un fichier dans le document. Détecte le type d’objet OLE à l’aide du paramètre progID donné.

public Shape InsertOleObject(string fileName, string progId, bool isLinked, bool asIcon, 
    Stream presentation)
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é.
asIconBooleanSpécifie le mode Iconique ou Normal de l’objet OLE en cours d’insertion.
presentationStreamPrésentation d’image de l’objet OLE. Si la valeur estnul Aspose.Words utilisera l’une des images prédéfinies.

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