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