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 для показа изображения. Статический метод.
Параметры
| Параметр | Описание | С версии |
|---|---|---|
| image | ID файла или путь к файлу на текущем сайте либо 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 |
| ImageUrlTemplate | 12.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-2025, «1С-Битрикс», 2025