ImageData

Наследование: java.lang.Object

public class ImageData

Определяет изображение для фигуры.

Чтобы узнать больше, посетитеWorking with Images документальная статья.

ИспользоватьShape.getImageData() свойство для доступа и изменения изображения внутри фигуры. Вы не создаете экземплярыImageData класс напрямую.

Изображение может быть сохранено внутри фигуры, связано с внешним файлом или и то, и другое (связано и сохранено в документе).

Независимо от того, хранится ли изображение внутри фигуры или связано, вы всегда можете получить доступ к фактическому изображению, используяtoByteArray(), toImage() или жеsave(java.lang.String) методы. Если изображение хранится внутри фигуры, вы также можете напрямую получить к нему доступ, используяgetImageBytes() / setImageBytes(byte[]) имущество.

Чтобы сохранить изображение внутри фигуры, используйтеsetImage(java.lang.String) метод. Чтобы связать изображение с фигурой, установитеgetSourceFullName() / setSourceFullName(java.lang.String) имущество.

Методы

МетодОписание
equals(Object arg0)
fetchInheritedBorderAttr(int key)
getBiLevel()Определяет, будет ли изображение отображаться черно-белым.
getBorders()Получает коллекцию границ изображения.
getBrightness()Получает яркость изображения.
getChromaKey()Определяет значение цвета изображения, которое будет рассматриваться как прозрачное.
getClass()
getContrast()Получает контраст для указанного изображения.
getCropBottom()Определяет долю удаления изображения с нижней стороны.
getCropLeft()Определяет долю удаления изображения с левой стороны.
getCropRight()Определяет долю удаления изображения с правой стороны.
getCropTop()Определяет долю удаления изображения с верхней стороны.
getDirectBorderAttr(int key)
getGrayScale()Определяет, будет ли изображение отображаться в режиме оттенков серого.
getImageBytes()Получает необработанные байты изображения, хранящиеся в форме.
getImageSize()Получает информацию о размере и разрешении изображения.
getImageType()Получает тип изображения.
getSourceFullName()Получает путь и имя исходного файла для связанного изображения.
getTitle()Определяет заголовок изображения.
hasImage()Возвращает true, если фигура содержит байты изображения или связывает изображение.
hashCode()
isLink()Возвращает true, если изображение связано с фигурой (когдаgetSourceFullName() / setSourceFullName(java.lang.String)уточняется).
isLinkOnly()Возвращает true, если изображение связано и не хранится в документе.
notify()
notifyAll()
save(OutputStream stream)
save(String fileName)Сохраняет изображение в файл.
setBiLevel(boolean value)Определяет, будет ли изображение отображаться черно-белым.
setBorderAttr(int key, Object value)
setBrightness(double value)Устанавливает яркость изображения.
setChromaKey(Color value)Определяет значение цвета изображения, которое будет рассматриваться как прозрачное.
setContrast(double value)Устанавливает контраст для указанного изображения.
setCropBottom(double value)Определяет долю удаления изображения с нижней стороны.
setCropLeft(double value)Определяет долю удаления изображения с левой стороны.
setCropRight(double value)Определяет долю удаления изображения с правой стороны.
setCropTop(double value)Определяет долю удаления изображения с верхней стороны.
setGrayScale(boolean value)Определяет, будет ли изображение отображаться в режиме оттенков серого.
setImage(BufferedImage image)Задает изображение, отображаемое фигурой.
setImage(InputStream stream)
setImage(String fileName)Задает изображение, отображаемое фигурой.
setImageBytes(byte[] value)Устанавливает необработанные байты изображения, хранящегося в форме.
setSourceFullName(String value)Задает путь и имя исходного файла для связанного изображения.
setTitle(String value)Определяет заголовок изображения.
toByteArray()Возвращает байты изображения для любого изображения, независимо от того, сохранено ли изображение или связано.
toImage()Получает изображение, хранящееся в форме, как объект java BufferedImage.
toStream()Создает и возвращает поток, содержащий байты изображения.
toString()
wait()
wait(long arg0)
wait(long arg0, int arg1)

equals(Object arg0)

public boolean equals(Object arg0)

Параметры:

ПараметрТипОписание
arg0java.lang.Object

Возвращает: логический

fetchInheritedBorderAttr(int key)

public Object fetchInheritedBorderAttr(int key)

Параметры:

ПараметрТипОписание
keyint

Возвращает: java.lang.Объект

getBiLevel()

public boolean getBiLevel()

Определяет, будет ли изображение отображаться черно-белым.

Значение по умолчаниюfalse.

Возвращает: boolean - соответствующее логическое значение.

getBorders()

public BorderCollection getBorders()

Получает коллекцию границ изображения. Границы действуют только для встроенных изображений.

Возвращает: BorderCollection - Коллекция границ изображения.

getBrightness()

public double getBrightness()

Получает яркость изображения. Значение этого свойства должно быть числом от 0,0 (самый тусклый) до 1,0 (самый яркий).

Значение по умолчанию — 0,5.

Возвращает: double - Яркость картинки.

getChromaKey()

public Color getChromaKey()

Определяет значение цвета изображения, которое будет рассматриваться как прозрачное.

Значение по умолчанию — 0.

Возвращает: java.awt.Color — соответствующее значение java.awt.Color.

getClass()

public final native Class<?> getClass()

Возвращает: java.lang.Класс

getContrast()

public double getContrast()

Получает контраст для указанного изображения. Значение этого свойства должно быть числом от 0,0 (наименьший контраст) до 1,0 (наибольший контраст).

Значение по умолчанию — 0,5.

Возвращает: double - Контраст для указанного изображения.

getCropBottom()

public double getCropBottom()

Определяет долю удаления изображения с нижней стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Возвращает: double - соответствующее двойное значение.

getCropLeft()

public double getCropLeft()

Определяет долю удаления изображения с левой стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Возвращает: double - соответствующее двойное значение.

getCropRight()

public double getCropRight()

Определяет долю удаления изображения с правой стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Возвращает: double - соответствующее двойное значение.

getCropTop()

public double getCropTop()

Определяет долю удаления изображения с верхней стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Возвращает: double - соответствующее двойное значение.

getDirectBorderAttr(int key)

public Object getDirectBorderAttr(int key)

Параметры:

ПараметрТипОписание
keyint

Возвращает: java.lang.Объект

getGrayScale()

public boolean getGrayScale()

Определяет, будет ли изображение отображаться в режиме оттенков серого.

Значение по умолчаниюfalse.

Возвращает: boolean - соответствующее логическое значение.

getImageBytes()

public byte[] getImageBytes()

Получает необработанные байты изображения, хранящиеся в форме.

Установка значения null или пустого массива удалит изображение из формы.

Возвращает null, если изображение не сохранено в документе (например, в этом случае изображение, вероятно, связано).

Возвращает: байт[] — необработанные байты изображения, хранящиеся в форме.

getImageSize()

public ImageSize getImageSize()

Получает информацию о размере и разрешении изображения. (4661,6)

Если изображение только связано и не хранится в документе, возвращается нулевой размер.

Возвращает: ImageSize - Информация о размере изображения и разрешении.

getImageType()

public int getImageType()

Получает тип изображения. (4671,6)

Возвращает: int - Тип изображения. Возвращаемое значение является одним изImageType константы.

getSourceFullName()

public String getSourceFullName()

Получает путь и имя исходного файла для связанного изображения.

Значение по умолчанию — пустая строка.

ЕслиgetSourceFullName() / setSourceFullName(java.lang.String) не пустая строка, изображение связано.

Возвращает: java.lang.String — путь и имя исходного файла связанного изображения.

getTitle()

public String getTitle()

Определяет заголовок изображения.

Значение по умолчанию — пустая строка.

Возвращает: java.lang.String — соответствующее значение java.lang.String.

hasImage()

public boolean hasImage()

Возвращает true, если фигура содержит байты изображения или связывает изображение. (4654,6)

Возвращает: boolean — True, если фигура содержит байты изображения или ссылается на изображение.

hashCode()

public native int hashCode()

Возвращает: инт

public boolean isLink()

Возвращает true, если изображение связано с фигурой (когдаgetSourceFullName() / setSourceFullName(java.lang.String) уточняется). (4678,6)

Возвращает: boolean — Истинно, если изображение связано с фигурой (когдаgetSourceFullName() / setSourceFullName(java.lang.String)уточняется).

isLinkOnly()

public boolean isLinkOnly()

Возвращает true, если изображение связано и не хранится в документе. (4685,6)

Возвращает: boolean — Истинно, если изображение связано и не хранится в документе.

notify()

public final native void notify()

notifyAll()

public final native void notifyAll()

save(OutputStream stream)

public void save(OutputStream stream)

Параметры:

ПараметрТипОписание
streamjava.io.OutputStream

save(String fileName)

public void save(String fileName)

Сохраняет изображение в файл.

Параметры:

ПараметрТипОписание
fileNamejava.lang.StringИмя файла, куда сохранить изображение.

setBiLevel(boolean value)

public void setBiLevel(boolean value)

Определяет, будет ли изображение отображаться черно-белым.

Значение по умолчаниюfalse.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setBorderAttr(int key, Object value)

public void setBorderAttr(int key, Object value)

Параметры:

ПараметрТипОписание
keyint
valuejava.lang.Object

setBrightness(double value)

public void setBrightness(double value)

Устанавливает яркость изображения. Значение этого свойства должно быть числом от 0,0 (самый тусклый) до 1,0 (самый яркий).

Значение по умолчанию — 0,5.

Параметры:

ПараметрТипОписание
valuedoubleЯркость картинки.

setChromaKey(Color value)

public void setChromaKey(Color value)

Определяет значение цвета изображения, которое будет рассматриваться как прозрачное.

Значение по умолчанию — 0.

Параметры:

ПараметрТипОписание
valuejava.awt.ColorСоответствующее значение java.awt.Color.

setContrast(double value)

public void setContrast(double value)

Устанавливает контраст для указанного изображения. Значение этого свойства должно быть числом от 0,0 (наименьший контраст) до 1,0 (наибольший контраст).

Значение по умолчанию — 0,5.

Параметры:

ПараметрТипОписание
valuedoubleКонтраст для указанного изображения.

setCropBottom(double value)

public void setCropBottom(double value)

Определяет долю удаления изображения с нижней стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Параметры:

ПараметрТипОписание
valuedoubleСоответствующее двойное значение.

setCropLeft(double value)

public void setCropLeft(double value)

Определяет долю удаления изображения с левой стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Параметры:

ПараметрТипОписание
valuedoubleСоответствующее двойное значение.

setCropRight(double value)

public void setCropRight(double value)

Определяет долю удаления изображения с правой стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Параметры:

ПараметрТипОписание
valuedoubleСоответствующее двойное значение.

setCropTop(double value)

public void setCropTop(double value)

Определяет долю удаления изображения с верхней стороны.

Величина обрезки может варьироваться от -1,0 до 1,0. Значение по умолчанию — 0. Обратите внимание, что при значении 1 изображение вообще не будет отображаться. Отрицательные значения приведут к тому, что изображение будет сжато внутрь от обрезаемого края (пустое пространство между изображением и обрезанным краем будет заполнено цветом заливки фигуры). Положительные значения меньше 1 приведут к тому, что оставшееся изображение будет растянуто, чтобы соответствовать форме.

Значение по умолчанию — 0.

Параметры:

ПараметрТипОписание
valuedoubleСоответствующее двойное значение.

setGrayScale(boolean value)

public void setGrayScale(boolean value)

Определяет, будет ли изображение отображаться в режиме оттенков серого.

Значение по умолчаниюfalse.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setImage(BufferedImage image)

public void setImage(BufferedImage image)

Задает изображение, отображаемое фигурой.

Параметры:

ПараметрТипОписание
imagejava.awt.image.BufferedImageОбъект изображения.

setImage(InputStream stream)

public void setImage(InputStream stream)

Параметры:

ПараметрТипОписание
streamjava.io.InputStream

setImage(String fileName)

public void setImage(String fileName)

Задает изображение, отображаемое фигурой.

Параметры:

ПараметрТипОписание
fileNamejava.lang.StringФайл изображения. Может быть именем файла или URL-адресом.

setImageBytes(byte[] value)

public void setImageBytes(byte[] value)

Устанавливает необработанные байты изображения, хранящегося в форме.

Установка значения null или пустого массива удалит изображение из формы.

Возвращает null, если изображение не сохранено в документе (например, в этом случае изображение, вероятно, связано).

Параметры:

ПараметрТипОписание
valuebyte[]Необработанные байты изображения, хранящиеся в форме.

setSourceFullName(String value)

public void setSourceFullName(String value)

Задает путь и имя исходного файла для связанного изображения.

Значение по умолчанию — пустая строка.

ЕслиgetSourceFullName() / setSourceFullName(java.lang.String) не пустая строка, изображение связано.

Параметры:

ПараметрТипОписание
valuejava.lang.StringПуть и имя исходного файла связанного изображения.

setTitle(String value)

public void setTitle(String value)

Определяет заголовок изображения.

Значение по умолчанию — пустая строка.

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

toByteArray()

public byte[] toByteArray()

Возвращает байты изображения для любого изображения, независимо от того, сохранено ли изображение или связано.

Возвращает: байт[] - Если изображение связано, загружает изображение каждый раз, когда оно вызывается.

toImage()

public BufferedImage toImage()

Получает изображение, хранящееся в форме, как объект java BufferedImage.

Возвращает: java.awt.image.BufferedImage — пытается создать новый объект java.awt.image.BufferedImage из байтов изображения при каждом вызове этого метода. Если javax.imageio.ImageReader не может прочитать байты изображения (emf, wmf, tiff и т. д.), метод возвращает null.

Вызывающий объект несет ответственность за удаление объекта изображения.

toStream()

public InputStream toStream()

Создает и возвращает поток, содержащий байты изображения.

Если байты изображения хранятся в форме, создает и возвращает объект.

Если изображение связано и хранится в файле, открывает файл и возвращает объект.

Если изображение связано и сохранено во внешнем URL-адресе, открывает URL-адрес и возвращает объект.

Ответственность за удаление объекта потока лежит на вызывающем объекте.

Это еще не перенесено на Java.

Возвращает: java.io.InputStream

toString()

public String toString()

Возвращает: java.lang.String

wait()

public final void wait()

wait(long arg0)

public final native void wait(long arg0)

Параметры:

ПараметрТипОписание
arg0long

wait(long arg0, int arg1)

public final void wait(long arg0, int arg1)

Параметры:

ПараметрТипОписание
arg0long
arg1int