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-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.