TCustomRichView.SavePicture

<< Нажмите, чтобы показать Содержание >>

TCustomRichView.SavePicture

Сохраняет изображение в файл. Метод используется при сохранении HTML, Markdown и XML (с использованием РВ-XML (TRichViewXML).

function SavePicture(DocumentSaveFormat: TRVSaveFormat;
  const ImagePrefix, Path: TRVUnicodeString; var ImageSaveNo: Integer;
  OverrideImages, InlineImage: Boolean; BackgroundColor: TRVColor; 
  gr: TRVGraphic; IsBackgroundImage = False): TRVUnicodeString; virtual;

Параметры:

gr – изображение, которое нужно сохранить.

DocumentSaveFormat – формат документа, который в данный момент сохраняется, см. TRVSaveFormat.

Path – путь для сохранения изображений.

Если DocumentSaveFormat=rvsfHTML или rvsfMarkdown, и формат изображения не зарегистрирован как веб-формат, изображение будет сохранено как Jpeg.

Если InlineImage = False:

ImagesPrefix – начальная часть имени файла. Имена файлов имеют формат ImagesPrefix + <генерируемый номер>.

ImageSaveNo – значение по умолчанию для <генерируемый номер> (см. выше). Если OverrideImages = True, используется ImageSaveNo. Если OverrideImages = False, <генерируемый номер> увеличивается до тех пор, пока не получится имя несуществующего файла.

Если InlineImage = True:

Изображение не сохраняется в файл, но возвращается его содержимое, закодированное в base64. Оно может быть использовано для сохранения изображения непосредственно в HTML.

BackgroundColor – цвет, который используется для фона (при конвертации прозрачных изображений в Jpeg).

IsBackgroundImage = True если сохраняемое изображение используется как фоновое.

 

Этот метод можно использовать в следующих событиях:

▪OnHTMLSaveImage,

▪OnSaveImage2,

▪OnSaveComponentToFile,

▪OnSaveItemToFile (SaveFormat=rvsfHTML или rvsfMarkdown).

 

Если метод используется при сохранении HTML, рекомендуется передавать:

▪OverrideImages = True если опция rvhtmlsioOverrideImages включена в HTMLSaveProperties.ImageOptions,

▪ImagesPrefix = HTMLSaveProperties.ImagesPrefix.

Если метод используется при сохранении Markdown, рекомендуется передавать:

▪OverrideImages = True если опция rvmdsoOverrideImages включена в MarkdownProperties.SaveOptions,

▪ImagesPrefix = MarkdownProperties.ImagesPrefix,

 

См. также:

▪Экспорт в HTML.