Документация для разработчиков
Темная тема

ShowImage

Описание и параметры

string
	CFile::ShowImage(
	mixed image,
	int MaxW = 0,
	int MaxH = 0,
	string Params = "border=0",
	string ImageUrl = "",
	bool popup = false,
	string PopupTitle = false,
	int SizeWHTTP = 0,
	int iSizeHHTTP = 0,
	string ImageUrlTemplate=""
)

Метод возвращает HTML для показа изображения. Статический метод.

Параметры

ПараметрОписание С версии
imageID файла или путь к файлу на текущем сайте либо URL к файлу лежащем на другом сайте. Если задается путь к файлу на текущем сайте, то его необходимо задавать относительно корня.
MaxWМаксимальная ширина изображения. Если ширина картинки больше max_width, то она будет пропорционально смаштабирована.
Необязательный. По умолчанию - "0" - без ограничений.
MaxHМаксимальная высота изображения. Если высота картинки больше max_height, то она будет пропорционально смаштабирована.
Необязательный. По умолчанию - "0" - без ограничений.
Если MaxW установлен в 0, то MaxH учитываться не будет. Чтобы ограничить высоту можно установить максимальную ширину в некое бо́льшее значение (например, 9999) вместо 0.
ParamsПроизвольный HTML добавляемый в тэг IMG:
<img image_params ...>
Необязательный. По умолчанию "null". Если в этом параметре передать атрибут alt="текст", то в теге <img> будет использовано это значение (с версии 8.5.1). Иначе, если картинка имеет описание в таблице b_file, для атрибута alt будет использовано это описание.
ImageUrlСсылка для перехода при нажатии на картинку.
Необязательный. По умолчанию "" - не выводить ссылку.
popupОткрывать ли при клике на изображении дополнительное popup окно с увеличенным изображением.
Необязательный. По умолчанию - "false".
PopupTitleТекст всплывающей подсказки на изображении (только если popup = true)
Необязательный. По умолчанию выводится фраза "Увеличить" на языке страницы.
SizeWHTTPШирина изображения (в пикселах) (только если в параметре image задан URL начинающийся с "http://")
Необязательный. По умолчанию "0".
3.0.21
SizeHHTTPВысота изображения (в пикселах) (только если в параметре image задан URL начинающийся с "http://")
Необязательный. По умолчанию "0".
3.0.21
ImageUrlTemplate12.0.8

Смотрите также

Примеры использования

<tr valign="top">
	<td align="right"><font class="tablefieldtext"><?echo 
		GetMessage("VOTE_IMAGE")?></font></td>
	<td><font class="tablebodytext"><?
	echo CFile::InputFile("IMAGE_ID", 20, $str_IMAGE_ID);
	if (strlen($str_IMAGE_ID)>0):
		?><br><?
		echo CFile::ShowImage($str_IMAGE_ID, 200, 200, "border=0", "", true);
	endif;
	?></font>
	</td>
</tr>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх