Aspose::Words::Drawing::ImageData::SetImage method
Contents
[
Hide
]ImageData::SetImage(const System::SharedPtr<System::Drawing::Image>&) method
Sets the image that the shape displays.
void Aspose::Words::Drawing::ImageData::SetImage(const System::SharedPtr<System::Drawing::Image> &image)
| Parameter | Type | Description |
|---|---|---|
| image | const System::SharedPtr<System::Drawing::Image>& | The image object. |
See Also
- Class ImageData
- Namespace Aspose::Words::Drawing
- Library Aspose.Words for C++
ImageData::SetImage(const System::SharedPtr<System::IO::Stream>&) method
Sets the image that the shape displays.
void Aspose::Words::Drawing::ImageData::SetImage(const System::SharedPtr<System::IO::Stream> &stream)
| Parameter | Type | Description |
|---|---|---|
| stream | const System::SharedPtr<System::IO::Stream>& | The stream that contains the image. |
See Also
- Class ImageData
- Namespace Aspose::Words::Drawing
- Library Aspose.Words for C++
ImageData::SetImage(const System::String&) method
Sets the image that the shape displays.
void Aspose::Words::Drawing::ImageData::SetImage(const System::String &fileName)
| Parameter | Type | Description |
|---|---|---|
| fileName | const System::String& | The image file. Can be a file name or a URL. |
Examples
Shows how to insert a linked image into a document.
auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
System::String imageFileName = get_ImageDir() + u"Windows MetaFile.wmf";
// Below are two ways of applying an image to a shape so that it can display it.
// 1 - Set the shape to contain the image.
auto shape = System::MakeObject<Aspose::Words::Drawing::Shape>(builder->get_Document(), Aspose::Words::Drawing::ShapeType::Image);
shape->set_WrapType(Aspose::Words::Drawing::WrapType::Inline);
shape->get_ImageData()->SetImage(imageFileName);
builder->InsertNode(shape);
doc->Save(get_ArtifactsDir() + u"Image.CreateLinkedImage.Embedded.docx");
// Every image that we store in shape will increase the size of our document.
ASSERT_TRUE(70000 < System::MakeObject<System::IO::FileInfo>(get_ArtifactsDir() + u"Image.CreateLinkedImage.Embedded.docx")->get_Length());
doc->get_FirstSection()->get_Body()->get_FirstParagraph()->RemoveAllChildren();
// 2 - Set the shape to link to an image file in the local file system.
shape = System::MakeObject<Aspose::Words::Drawing::Shape>(builder->get_Document(), Aspose::Words::Drawing::ShapeType::Image);
shape->set_WrapType(Aspose::Words::Drawing::WrapType::Inline);
shape->get_ImageData()->set_SourceFullName(imageFileName);
builder->InsertNode(shape);
doc->Save(get_ArtifactsDir() + u"Image.CreateLinkedImage.Linked.docx");
// Linking to images will save space and result in a smaller document.
// However, the document can only display the image correctly while
// the image file is present at the location that the shape's "SourceFullName" property points to.
ASSERT_TRUE(10000 > System::MakeObject<System::IO::FileInfo>(get_ArtifactsDir() + u"Image.CreateLinkedImage.Linked.docx")->get_Length());
See Also
- Class ImageData
- Namespace Aspose::Words::Drawing
- Library Aspose.Words for C++
ImageData::SetImage(std::basic_istream<CharType, Traits>&) method
template<typename CharType,typename Traits> void Aspose::Words::Drawing::ImageData::SetImage(std::basic_istream<CharType, Traits> &stream)
See Also
- Class ImageData
- Namespace Aspose::Words::Drawing
- Library Aspose.Words for C++