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

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-2020, «1С-Битрикс», 2020
Наверх