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

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