OneNote permite recopilar, organizar y colaborar con información de forma libre y colaboración de varios usuarios en forma de notas, dibujos, recortes de pantalla y comentarios de audio. Podemos insertar imágenes en documentos de OneNote mediante programación. En este artículo, aprenderemos cómo agregar una imagen a OneNote en C#.
En este artículo se tratarán los siguientes temas:
- API de C# para agregar imágenes a OneNote
- Agregar imagen a un nuevo documento de OneNote
- Insertar imagen en un documento de OneNote existente
- Agregar imagen con texto alternativo
API de C# para agregar imágenes a OneNote
Para agregar una imagen a un documento de OneNote nuevo o existente, usaremos la API Aspose.Note para .NET. La API permite crear, leer y convertir documentos de OneNote mediante programación sin usar Microsoft OneNote. También permite importar contenido de documentos PDF a documentos de OneNote.
Descargue la DLL de la API o instálela mediante NuGet.
PM> Install-Package Aspose.Note
Agregar imagen al nuevo documento de OneNote en C#
Podemos crear un nuevo documento de OneNote e insertar una imagen siguiendo los pasos que se detallan a continuación:
- En primer lugar, cree una instancia de la clase Documento.
- A continuación, inicialice el objeto de la clase Page.
- Luego, carga una imagen usando la clase Image.
- Opcionalmente, establezca la altura, el ancho, la alineación, el desplazamiento, etc. de la imagen.
- Después de eso, agregue la imagen a la página usando el método AppendChildLast().
- Del mismo modo, agregue la página al documento.
- Finalmente, llame al método Save() para guardar el documento de OneNote.
El siguiente ejemplo de código muestra cómo agregar una imagen a un nuevo documento de OneNote mediante C#.
// Este ejemplo de código demuestra cómo agregar una imagen a un nuevo documento de OneNote.
// La ruta al directorio de documentos.
string dataDir = "C:\\Files\\Note\\";
// Crear un objeto de la clase Documento
Document doc = new Document();
// Inicializar objeto de clase de página
Page page = new Page();
// Cargue una imagen por la ruta del archivo.
Image image = new Image(dataDir + "sample.jpg");
// Establecer la alineación de la imagen
image.Alignment = HorizontalAlignment.Right;
// Añadir imagen
page.AppendChildLast(image);
// Agregar nodo de página
doc.AppendChildLast(page);
// Guardar documento de OneNote
dataDir = dataDir + "CreateOneNoteWithImage.one";
doc.Save(dataDir);
Agregue una imagen al nuevo documento de OneNote en C#.
Agregar imagen a un documento de OneNote existente en C#
También podemos insertar una imagen en un documento de OneNote existente siguiendo los pasos que se detallan a continuación:
- En primer lugar, cargue un OneNote existente utilizando la clase Documento.
- A continuación, inicialice el objeto de la clase Page.
- Luego, carga una imagen usando la clase Image.
- Opcionalmente, establezca la altura, el ancho, la alineación, el desplazamiento, etc. de la imagen.
- Después de eso, agregue la imagen a la página usando el método AppendChildLast().
- Del mismo modo, agregue la página al documento.
- Finalmente, llame al método Save() para guardar el documento de OneNote.
El siguiente ejemplo de código muestra cómo agregar una imagen a un documento de OneNote existente mediante C#.
// Este ejemplo de código muestra cómo agregar una imagen a un documento de OneNote existente.
// La ruta al directorio de documentos.
string dataDir = "C:\\Files\\Note\\";
// Cargue el documento desde la transmisión.
Document doc = new Document(dataDir + "Sample1.one");
// Agregar una nueva página.
Page page = new Page();
// Cargue una imagen del archivo.
Image image = new Image(dataDir + "sample.jpg");
// Cambia el tamaño de la imagen según tus necesidades (opcional).
image.Width = 500;
image.Height = 750;
// Establezca la ubicación de la imagen en la página (opcional).
image.VerticalOffset = 400;
image.HorizontalOffset = 100;
// Establecer la alineación de la imagen
image.Alignment = HorizontalAlignment.Right;
// Agrega la imagen a la página.
page.AppendChildLast(image);
doc.AppendChildLast(page);
// Guardar documento de OneNote
dataDir = dataDir + "InsertImageIntoExisting.one";
doc.Save(dataDir);
Insertar imagen con texto alternativo en OneNote usando C#
Podemos agregar texto alternativo a la imagen mientras lo insertamos en un documento de OneNote siguiendo los pasos que se detallan a continuación:
- En primer lugar, cree una instancia de la clase Documento.
- A continuación, inicialice el objeto de la clase Page.
- Luego, carga una imagen usando la clase Image.
- A continuación, especifique las propiedades AlternativeTextTitle y AlternativeTextDescription.
- Después de eso, agregue la imagen a la página usando el método AppendChildLast().
- Del mismo modo, agregue la página al documento.
- Finalmente, llame al método Save() para guardar el documento de OneNote.
El siguiente ejemplo de código muestra cómo insertar una imagen con texto alternativo en OneNote usando C#.
// Este ejemplo de código muestra cómo agregar una imagen con texto alternativo en un documento de OneNote.
// La ruta al directorio de documentos.
string dataDir = "C:\\Files\\Note\\";
// Crear un nuevo documento
var document = new Document();
// Agregar una nueva página
var page = new Page();
// Cargar una imagen
var image = new Image(dataDir + "sample.jpg");
// Especifique el texto y la descripción alternativos de la imagen
image.AlternativeTextTitle = "This is an image's title!";
image.AlternativeTextDescription = "And this is an image's description!";
// Adjuntar una imagen
page.AppendChildLast(image);
// Añadir página
document.AppendChildLast(page);
// Guardar el documento
dataDir = dataDir + "ImageAlternativeText.one";
document.Save(dataDir);
Obtenga una licencia gratis
Puede obtener una licencia temporal gratuita para probar la biblioteca sin limitaciones de evaluación.
Conclusión
En este artículo, hemos aprendido a:
- crear un nuevo documento de OneNote usando C#;
- cargar un documento de OneNote existente;
- agregar una página al documento de OneNote;
- agregue una imagen a la página del documento de OneNote mediante programación;
Además de agregar una imagen a OneNote en C#, puede obtener más información sobre Aspose.Note para la API de .NET mediante la documentación. En caso de cualquier ambigüedad, no dude en contactarnos en nuestro foro de soporte gratuito.