Что такое код imageinterlace

Содержание

imageinterlace

imageinterlace — Enable or disable interlace

Описание

imageinterlace() turns the interlace bit on or off.

If the interlace bit is set and the image is used as a JPEG image, the image is created as a progressive JPEG .

Список параметров

Ресурс изображения, полученный одной из функций создания изображений, например, такой как imagecreatetruecolor() .

If non-zero, the image will be interlaced, else the interlace bit is turned off.

Возвращаемые значения

Returns 1 if the interlace bit is set for the image, 0 otherwise.

Примеры

Пример #1 Turn on interlacing using imageinterlace()

// Create an image instance
$im = imagecreatefromgif ( ‘php.gif’ );

// Enable interlancing
imageinterlace ( $im , true );

imageinterlace

imageinterlace — Enable or disable interlace

Описание

imageinterlace() turns the interlace bit on or off.

If the interlace bit is set and the image is used as a JPEG image, the image is created as a progressive JPEG .

Список параметров

Ресурс изображения, полученный одной из функций создания изображений, например, такой как imagecreatetruecolor() .

If non-zero, the image will be interlaced, else the interlace bit is turned off.

Возвращаемые значения

Returns 1 if the interlace bit is set for the image, 0 otherwise.

Примеры

Пример #1 Turn on interlacing using imageinterlace()

// Create an image instance
$im = imagecreatefromgif ( ‘php.gif’ );

// Enable interlancing
imageinterlace ( $im , true );

Что такое код imageinterlace

imageinterlace — включает/отключает interlace/чередование.

Описание

int imageinterlace (resource image [, int interlace])

imageinterlace() включает/отключает interlace-бит. Если interlace равен 1, изображение будет interlaced, а если 0 — interlace-бит будет выключен.

Если interlace-бит установлен и изображение используется как JPEG-изображение, изображение создаётся как progressive JPEG.

Эта функция возвращает interlace-бит изображения.

Что такое код imageinterlace

(PHP 3, PHP 4, PHP 5)

imageinterlace — Enable or disable interlace

Description int imageinterlace ( resource image [, int interlace] )

imageinterlace() turns the interlace bit on or off. If interlace is 1 the image will be interlaced, and if interlace is 0 the interlace bit is turned off.

If the interlace bit is set and the image is used as a JPEG image, the image is created as a progressive JPEG.

This function returns whether the interlace bit is set for the image.

Что такое код imageinterlace

Скидка 25% на все тарифы хостинга по промокоду STDCITF

Вы можете использовать фуннкции работы с изображениями для получения размеров картинок в файлах JPEG, GIF, PNG, и, если у Вас есть библиотека GD (доступна на http://www.boutell.com/gd/), Вы также будете иметь возможность создавать GIF-изображения и управлять ими.

GetImageSize

Описание

Функция GetImageSize() определяет размеры любых изображений в файлах GIF , JPG или PNG и возвращает размерность вместе с типом файла и строкой в формате высота/ширина, которую можно использовать в стандартном теге HTML IMG .

Возвращается массив из четырех элементов. Индекс 0 содержит ширину изображения в пикселах. Элемент 1 содержит высоту. Элемент 2 — флаг типа изображения. 1 = GIF, 2 = JPG, 3 = PNG. Элемент 3 — строку с корректным заданием «height=xxx w >

Пример 1. GetImageSize

Опциональный параметр imageinfo позволяет Вам получить некоторую дополнительную информацию о файле изображения. Сейчас возвращаеются разнообразные JPG APP маркеры в ассоцированном массиве. Некоторые программы используют эти APP для встраивания текстовой информации в изображение. Очень распространено встраивание IPTC http://www.xe.net/iptc/ информации в APP13 маркер. Вы можете использовать функцию iptcparse() для перевода бинарного APP13 маркера в нечто читабельное.

Пример 2. GetImageSize возвращает IPTC

Примечание: Эта функция не требует библиотеки GD.

ImageArc

Описание

ImageArc рисует чать эллипса с центро в cx, cy (верхний левый угол — 0,0) в изображении im. w и h определяют высоту и ширину эллипса в соответствии с начальной и конечной точкой, определенными в аргументах s и e.

ImageChar

Описание

ImageChar рисует первый символ из c в рисунке id с верхним левым углом в x , y (верхний левый — 0,0) цветом col . Шрифтом 1, 2, 3, 4 или 5, используются встроенные шрифты (больше цифра — больше шрифт).

ImageCharUp

Описание

ImageCharUp рисует символ c вертикально в изображении im по координатам x, y (верхний левый — 0, 0) с цветом col. Если font равен 1, 2, 3, 4 или 5, используются встроенные шрифты.

ImageColorAllocate

Описание

ImageColorAllocate возвращает цвет в схеме RGB. Аргумент im возвращается функцией imagecreate() . ImageColorAllocate должна быть вызвана для создания каждого цвета, который планируется использовать в изображении, представленном im.

ImageColorTransparent

Описание

ImageColorTransparent устанавливает прозрачный цвет в изображении im в col. im — идентификатор изображения, возвращенный imagecreate() , а col — идентификатор цвета, возвращенный функцией imagecolorallocate() .

Возвращается идентификатор нового (или текущего, если не указан параметр col) прозрачного цвета.

ImageCopyResized

Описание

ImageCopyResized копир область одного изображения в другое. dst_im — изображение-получатель, src_im — исходное изображение. Если координаты исходного и результирующего изображений различны по ширине и высоте, производится соответствующее сжатие/растягивание фрагмента изображения. Координаты — относительно левого верхнего угла. Функция может быть использована для копирования фрагментов одного и того же изображения (если dst_im равно src_im ) но если области перекроются, результат может быть непредсказуемым.

ImageCreate

Описание

ImageCreate возвращает идентификатор изображения чистого листа размерами x_size на y_size.

ImageCreateFromGif

Описание

ImageCreateFromGif возвращает идентификатор изображения, полученного из filename.

ImageDashedLine

Описание

ImageLine рисует пунктирную линию от x1,y1 до x2,y2 (верхний левй угол — 0,0) в изображении im цветом col.

ImageDestroy

Описание

ImageDestroy освобождает память, ассоциированную с изображением im. im — идентификатор, возвращенный функцией imagecreate() .

ImageFill

Описание

ImageFill выполняет заливку, начиная с координат x, y (верхний левй угол — 0,0) цветом col изображения im.

ImageFilledPolygon

Описание

ImageFilledPolygon создает закрашенный многоугольник в изображении im. points — массив PHP содержит вершины многоугольника: num_points — общее число вершин.

ImageFilledRectangle

Описание

ImageFilledRectangle создает закрашенный прямоугольник цвета col в изображении im, начиная с координат верхнего левого угла x1, y1, и заканчивая в правом нижнем — x2, y2. 0, 0 — левый верхний угол изображения.

ImageFillToBorder

Описание

ImageFillToBorder выполняет заливку до границы, определенной цветом в border. Начальная точка заливки — x,y (верхний левый угол — 0,0) и облласть заливается цветом col.

ImageFontHeight

Описание

Возвращает высоту шрифта font в пикселах.

ImageFontWidth

Описание

Возвращает ширину символа шрифта font в пикселах.

ImageGif

Описание

ImageGif создает GIF файл с именем filename из изображения im. Аргумент im возвращается функцией imagecreate().

Формат изображения будет соответствовать спецификации GIF87a, если изображение не было сделано прозрачным функцией imagecolortransparent() , в этом случае формат будет соответствовать GIF89a.

Аргумент filename опционален, и если он отсутствует, строки изображения будут выводиться непосредственно на брайзер потоком. Указав тип изображения image/gif в функции header, вы можете создавать PHP скрипты, которые будут выводить GIF на браузер.

ImageInterlace

Описание

ImageInterlace() переключает бит чередования. Если interlace равен 1, изображение im будет выводиться поэтапно, и если interlace равно 0, чередование выключено.

Возвращается текущее состояние бита чередования для изображения.

ImageLine

Описание

ImageLine рисует линию от x1,y1 до x2,y2 (левй верхний точка — 0,0) в изображении im цветом col.

ImageLoadFont

Описание

ImageLoadFont загружает пользовательский растровый шрифт и возвращает идентификатор шрифта (который всегда больше 5, тобы не вызвать конфликта со встроенными шрифтами).

Файл шрифта — двоичный и архиетктурно зависимый. Это значит, что Вам следует генерировать файл шрифта на том процессоре (архитектуре), на котором Вы будете запускать PHP.

Таблица 1. Формат файла шрифта

позиция байта тип данных C Описание
байты 0-3 int число символов в шрифте
байты 4-7 int значение первого символа в шрифте (часто 32 для пробела)
байты 8-11 int ширина символов в пикселах
байты 12-15 int высота символов в пикселах
байты 16- char массив с данными на символы, один байт на пиксел, для каждого символа — nchars*width*height.

ImagePolygon

Описание

ImagePolygon создает многоугольник в изображении im. points — массив PHP, содержащий вершины многоугольника, т.е points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, etc. num_points — общее число вершин.

ImageRectangle

Описание

ImageRectangle создает прямоугольник цветом col в изображении im, начиния с левой верхней координаты x1,y1 и заканчивая нижней правой x2,y2. 0,0 — левй верхний угол изображения.

ImageSetPixel

Описание

ImageSetPixel рисует пиксел x,y (верхний левый — 0,0) в изображении im цветом col.

ImageString

Описание

ImageString рисует строку s в изображении im по координатам x,y (верхний левый — 0,0) цветом col. Если font равен 1, 2, 3, 4 или 5, используются встроенные шрифты.

ImageStringUp

Описание

ImageStringUp рисует строку s вертикально в изображении im по координатам x,y (верхний левый — 0,0) цветом col. Если font равен 1, 2, 3, 4 или 5, используются встроенные шрифты.

ImageSX

Описание

ImageSX возвращает ширину изображения, определяемого im.

ImageSY

Описание

ImageSY возвращает высоту изображения, определяемого im.

ImageTTFBBox

Описание

Функция рассчитывает и возвращает границы области (в пикселах) для текста с шрифтами TrueType.

Измеряемая строка. size

Размер шрифта. fontfile

Имя файла TrueType шрифта. (Может быть и URL.) angle

Угол в градусах, под которым наклонен измеряемый text . ImageTTFBBox() возвращает массив из 8-и элементов, представляющих четыре точки границы области текста:

нижний левый угол, позиция X
1 нижний левый угол, позиция Y
2 нижний правый угол, позиция X
3 нижний правый угол, позиция Y
4 верхний правый угол, позиция X
5 верхний правый угол, позиция Y
6 верхний левый угол, позиция X
7 верхний левый угол, позиция Y

Точки относятся к text безотносительно к углу, т.е «верхний левый» означает верхний левый угол текста при его горизонтальном расположении.

Функция требует две библиотеки: GD и Freetype.

ImageTTFText

Описание

ImageTTFText рисует строку text в изображении, идентифицируемом im , начиная с координат x,y (верхняя левая — 0,0), под углом angle цветом col , используя файл TrueType шрифта, указанный в fontfile .

Координаты, указанные в x , y определяют базовую точку символа (приблизительно нижний левый угол). Это отличается от ImageString() , где x,y определяют верхний правый угол первого символа.

angle в градусах, 0 означает написание текста с лава на право (в направлении на 3 часа), более высокие значения — поворот против часовой стрелки (т.е. 90 — написание текста с низу вверх).

fontfile — путь к файлу шрифта TrueType, который планируется использовать.

text — строка текста, которая может включать символы UTF-8 (в форма: < ) для доступа к сиволам за пределами первых 255.

col индекс цвета. Использование отрицания индекса цвета имеет эффект включения антиалиасинга.

ImageTTFText() возвращает массив из 8 элементов, представляющих четыре точки границы области вывода текста. Порядок точек: вепхняя левая, верхняя правая, нижняя правая, нижняя левая. ТОчки относятся к тексту без учета угла, т.е. «верхняя левая» означает верхний левый угол горизонтально расположенного текста.

Скрипт этого примера создает черный GIF 400×30 пикселей, со словом «Testing. «, написанным шрифтом Arial.

Пример 1. ImageTTFText

ImageColorAt

Описание

Returns the index of the color of the pixel at the specified location in the image.

ImageColorClosest

Описание

Возвращает индекс цвета в палитре изображения, который «ближе всего» к указанному набору RGB.

«Дистанция» между желанным цветом и каждым цветом в палитре определяется так, как будто значения RGB определяют точки в трехмерном пространстве.

ImageColorExact

Описание

Возвращает индекс указанного цвета в палитре изображения.

Если цвет в палитре изображения не присутствует, возвращается -1.

ImageColorResolve

Описание

Эта функция всегда возвращает индекс для запрашиваемого цвета, одно из двух — или указанный цвет, или ближайшую альтернативу.

ImageColorSet

Описание

Эти установки устанавливают соответствие между индексом в палитре и цветом. это используется для создания эффектов сплошной заливки в палитре изображения без накладных расходов преобразования текущей заливки.

ImageColorsForIndex

Описание

Возвращается ассоциативный массив с красным, синим и зеленым ключами, которые содержат соответствующие значения для указанного индекса цвета.

ImageColorsTotal

Описание

Возвращает количество цветов в указанной палитре.

Что такое код imageinterlace

(PHP 3, PHP 4 , PHP 5)

imageinterlace — Enable or disable interlace

Description int imageinterlace ( resource image [, int interlace] )

imageinterlace() turns the interlace bit on or off. If interlace is 1 the image will be interlaced, and if interlace is 0 the interlace bit is turned off.

If the interlace bit is set and the image is used as a JPEG image, the image is created as a progressive JPEG.

This function returns whether the interlace bit is set for the image.

About MichaelSoft’s note «Imageinterlace($im, 1) creates a JPG which is first loaded completely before showing anything»:

Actually, that’s not completely true.
This only happens with Internet Explorer (any version, for the time being) as it doesn’t seem to support progressive displaying and rather shows the image, when it’s 100% done with loading. Other browsers (Mozilla, Mozilla Firefox, Opera, Konqueror, etc.) do their job as they’re supposed to do: Displaying a very low-res image, then overlaying a midlow-res image (while loading), and then displaying more and more details.

There is a bug in Microsoft Internet Explorer (at least at present) that means that often, a progressive/interlaced JPEG will actually NOT show at all whilst loading, suddenly appearing only when the entire picture has loaded. A regular NON-interlaced/NON-progressive JPEG will display line by line as it loads, which paradoxically gives the illusion that it’s loading faster. MSIE definitely has this one backwards!!

This behaviour is not apparent in other browsers such as Mozilla/FireFox — in these browsers, the image loads progressively, as it should.

Класс CImageList CImageList Class

Предоставляет функциональные возможности стандартного элемента управления «список изображений» Windows. Provides the functionality of the Windows common image list control.

Синтаксис Syntax

Участники Members

Открытые конструкторы Public Constructors

name Name Описание Description
CImageList:: CImageList CImageList::CImageList Создает объект CImageList . Constructs a CImageList object.

Открытые методы Public Methods

name Name Описание Description
CImageList:: Add CImageList::Add Добавляет изображение или изображения в список изображений. Adds an image or images to an image list.
CImageList:: Attach CImageList::Attach Присоединяет список изображений к CImageList объекту. Attaches an image list to a CImageList object.
CImageList:: Бегиндраг CImageList::BeginDrag Начинает перетаскивать изображение. Begins dragging an image.
CImageList:: Copy CImageList::Copy Копирует изображение в CImageList объект. Copies an image within a CImageList object.
CImageList:: Create CImageList::Create Инициализирует список изображений и прикрепляет его к CImageList объекту. Initializes an image list and attaches it to a CImageList object.
CImageList::D Елетеимажелист CImageList::DeleteImageList Удаляет список изображений. Deletes an image list.
CImageList::D Елететемпмап CImageList::DeleteTempMap Вызывается обработчиком времени простоя CWinApp для удаления любого временного CImageList объекта, FromHandle созданного. Called by the CWinApp idle-time handler to delete any temporary CImageList object created by FromHandle .
CImageList::D етач CImageList::Detach Отсоединяет объект списка изображений от CImageList объекта и возвращает маркер в список изображений. Detaches an image list object from a CImageList object and returns a handle to an image list.
CImageList::D Ражентер CImageList::DragEnter Блокирует обновления во время операции перетаскивания и отображает изображение перетаскивания в указанной позиции. Locks updates during a drag operation and displays the drag image at a specified position.
CImageList::D Раглеаве CImageList::DragLeave Разблокирует окно и скрывает изображение перетаскивания, чтобы можно было обновить окно. Unlocks the window and hides the drag image so that the window can be updated.
CImageList::D Рагмове CImageList::DragMove Перемещает изображение, которое перетаскивается во время операции перетаскивания. Moves the image that is being dragged during a drag-and-drop operation.
CImageList::D Рагшовнолокк CImageList::DragShowNolock Показывает или скрывает изображение перетаскивания во время операции перетаскивания без блокировки окна. Shows or hides the drag image during a drag operation, without locking the window.
CImageList::D RAW CImageList::Draw Рисует изображение, которое перетаскивается во время операции перетаскивания. Draws the image that is being dragged during a drag-and-drop operation.
CImageList::D Равекс CImageList::DrawEx Рисует элемент списка изображений в указанном контексте устройства. Draws an image list item in the specified device context. Функция использует указанный стиль рисования и смешивает изображение с указанным цветом. The function uses the specified drawing style and blends the image with the specified color.
CImageList::D Равиндирект CImageList::DrawIndirect Рисует изображение из списка изображений. Draws an image from an image list.
CImageList:: Енддраг CImageList::EndDrag Завершает операцию перетаскивания. Ends a drag operation.
CImageList:: Екстрактикон CImageList::ExtractIcon Создает значок на основе изображения и маски в списке изображений. Creates an icon based on an image and mask in an image list.
CImageList:: FromHandle CImageList::FromHandle Возвращает указатель на CImageList объект при наличии маркера для списка изображений. Returns a pointer to a CImageList object when given a handle to an image list. Если объект CImageList не прикреплен к дескриптору, создается и прикрепляется временный объект CImageList . If a CImageList object is not attached to the handle, a temporary CImageList object is created and attached.
CImageList:: Фромхандлеперманент CImageList::FromHandlePermanent Возвращает указатель на CImageList объект при наличии маркера для списка изображений. Returns a pointer to a CImageList object when given a handle to an image list. CImageList Если объект не присоединен к маркеру, возвращается значение null. If a CImageList object is not attached to the handle, NULL is returned.
CImageList:: Жетбкколор CImageList::GetBkColor Извлекает текущий цвет фона для списка изображений. Retrieves the current background color for an image list.
CImageList:: Жетдрагимаже CImageList::GetDragImage Возвращает временный список изображений, используемый для перетаскивания. Gets the temporary image list that is used for dragging.
CImageList:: Жетимажекаунт CImageList::GetImageCount Извлекает количество образов в списке изображений. Retrieves the number of images in an image list.
CImageList:: Жетимажеинфо CImageList::GetImageInfo Извлекает сведения о изображении. Retrieves information about an image.
CImageList:: Жетсафехандле CImageList::GetSafeHandle Извлекает m_hImageList . Retrieves m_hImageList .
CImageList:: Read CImageList::Read Считывает список изображений из архива. Reads an image list from an archive.
CImageList:: Remove CImageList::Remove Удаляет изображение из списка изображений. Removes an image from an image list.
CImageList:: Replace CImageList::Replace Заменяет изображение в списке изображений новым изображением. Replaces an image in an image list with a new image.
CImageList:: Сетбкколор CImageList::SetBkColor Задает цвет фона для списка изображений. Sets the background color for an image list.
CImageList:: Сетдрагкурсоримаже CImageList::SetDragCursorImage Создает новое изображение перетаскивания. Creates a new drag image.
CImageList:: Сетимажекаунт CImageList::SetImageCount Сбрасывает число образов в списке изображений. Resets the count of images in an image list.
CImageList:: Сетоверлайимаже CImageList::SetOverlayImage Добавляет Отсчитываемый от нуля индекс изображения в список изображений, которые будут использоваться в качестве масок наложения. Adds the zero-based index of an image to the list of images to be used as overlay masks.
CImageList:: Write CImageList::Write Записывает список образов в архив. Writes an image list to an archive.

Открытые операторы Public Operators

name Name Описание Description
CImageList:: operator ХИМАЖЕЛИСТ CImageList::operator HIMAGELIST Возвращает ХИМАЖЕЛИСТ, присоединенный к CImageList . Returns the HIMAGELIST attached to the CImageList .

Открытые члены данных Public Data Members

name Name Описание Description
CImageList::m_hImageList CImageList::m_hImageList Маркер, содержащий список изображений, прикрепленных к этому объекту. A handle containing the image list attached to this object.

Примечания Remarks

«Список изображений» — это коллекция изображений одинакового размера, на каждый из которых может ссылаться индекс, начинающийся с нуля. An «image list» is a collection of same-sized images, each of which can be referred to by its zero-based index. Списки изображений используются для эффективного управления большими наборами значков или точечных рисунков. Image lists are used to efficiently manage large sets of icons or bitmaps. Все изображения в списке изображений содержатся в одном расширенном точечном рисунке в формате экранного устройства. All images in an image list are contained in a single, wide bitmap in screen device format. Список изображений может также включать монохромное растровое изображение, которое содержит маски, используемые для прозрачного рисования изображений (стиль значка). An image list may also include a monochrome bitmap that contains masks used to draw images transparently (icon style). Интерфейс прикладного программирования (API) Microsoft Win32 предоставляет функции списка изображений, позволяющие рисовать изображения, создавать и уничтожать списки изображений, добавлять и удалять изображения, заменять изображения, объединять изображения и перетаскивать изображения. The Microsoft Win32 application programming interface (API) provides image list functions that enable you to draw images, create and destroy image lists, add and remove images, replace images, merge images, and drag images.

Этот элемент управления (и, CImageList следовательно, класс) доступен только для программ, работающих под управлением Windows 95/98 и Windows NT версии 3,51 и более поздних версий. This control (and therefore the CImageList class) is available only to programs running under Windows 95/98 and Windows NT version 3.51 and later.

Дополнительные сведения об использовании CImageList см. в разделе элементы управления и Использование CImageList. For more information on using CImageList , see Controls and Using CImageList.

Иерархия наследования Inheritance Hierarchy

Требования Requirements

Заголовок: afxcmn.h Header: afxcmn.h

CImageList:: Add CImageList::Add

Вызовите эту функцию, чтобы добавить одно или несколько изображений или значок в список изображений. Call this function to add one or more images or an icon to an image list.

Параметры Parameters

пбмимаже pbmImage
Указатель на точечный рисунок, содержащий изображение или изображения. Pointer to the bitmap containing the image or images. Число изображений выводится из ширины точечного рисунка. The number of images is inferred from the width of the bitmap.

пбммаск pbmMask
Указатель на точечный рисунок, содержащий маску. Pointer to the bitmap containing the mask. Если в списке изображений не используется маска, этот параметр игнорируется. If no mask is used with the image list, this parameter is ignored.

крмаск crMask
Цвет, используемый для создания маски. Color used to generate the mask. Каждый пиксел этого цвета в заданном растровом изображении изменяется на черный, а соответствующий бит в маске имеет значение 1. Each pixel of this color in the given bitmap is changed to black and the corresponding bit in the mask is set to one.

hIcon hIcon
Маркер значка, который содержит растровое изображение и маску для нового изображения. Handle of the icon that contains the bitmap and mask for the new image.

Возвращаемое значение Return Value

Отсчитываемый от нуля индекс первого нового образа в случае успеха; в противном случае — 1. Zero-based index of the first new image if successful; otherwise — 1.

Примечания Remarks

Вы несете ответственность за освобождение маркера значка по завершении работы с ним. You are responsible for releasing the icon handle when you are done with it.

Пример Example

CImageList:: Attach CImageList::Attach

Вызовите эту функцию, чтобы присоединить список изображений CImageList к объекту. Call this function to attach an image list to a CImageList object.

Параметры Parameters

hImageList hImageList
Маркер объекта списка изображений. A handle to an image list object.

Возвращаемое значение Return Value

Ненулевое значение, если вложение прошло успешно; в противном случае — 0. Nonzero if the attachment was successful; otherwise 0.

Пример Example

CImageList:: Бегиндраг CImageList::BeginDrag

Вызовите эту функцию, чтобы начать перетягивание изображения. Call this function to begin dragging an image.

Параметры Parameters

нимаже nImage
Отсчитываемый от нуля индекс изображения для перетаскивания. Zero-based index of the image to drag.

псотспот ptHotSpot
Координаты начальной позиции перетаскивания (как правило, позиции курсора). Coordinates of the starting drag position (typically, the cursor position). Координаты задаются относительно верхнего левого угла изображения. The coordinates are relative to the upper left corner of the image.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Эта функция создает временный список изображений, который используется для перетаскивания. This function creates a temporary image list that is used for dragging. Изображение объединяет указанное изображение и его маску с текущим курсором. The image combines the specified image and its mask with the current cursor. В ответ на последующие сообщения WM_MOUSEMOVE можно переместить изображение перетаскивания с помощью DragMove функции члена. In response to subsequent WM_MOUSEMOVE messages, you can move the drag image by using the DragMove member function. Чтобы завершить операцию перетаскивания, можно использовать EndDrag функцию члена. To end the drag operation, you can use the EndDrag member function.

Пример Example

CImageList:: CImageList CImageList::CImageList

Создает объект CImageList . Constructs a CImageList object.

CImageList:: Copy CImageList::Copy

Эта функция члена реализует поведение функции Win32 ImageList_Copy, как описано в Windows SDK. This member function implements the behavior of the Win32 function ImageList_Copy, as described in the Windows SDK.

Параметры Parameters

идст iDst
Отсчитываемый от нуля индекс изображения, которое будет использоваться в качестве назначения для операции копирования. The zero-based index of the image to be used as the destination of the copy operation.

исрк iSrc
Отсчитываемый от нуля индекс изображения, используемого в качестве источника операции копирования. The zero-based index of the image to be used as the source of the copy operation.

уфлагс uFlags
Значение битового флага, указывающее тип выполняемой операции копирования. The bit flag value that specifies the type of copy operation to be made. Этот параметр может принимать одно из следующих значений: This parameter can be one of the following values:

Значение Value Значение Meaning
ILCF_MOVE ILCF_MOVE Исходное изображение копируется в индекс конечного образа. The source image is copied to the destination image’s index. Эта операция приводит к получению нескольких экземпляров заданного образа. This operation results in multiple instances of a given image. По умолчанию используется ILCF_MOVE. ILCF_MOVE is the default.
ILCF_SWAP ILCF_SWAP Координаты исходного и конечного образов находятся в списке образов. The source and destination images exchange positions within the image list.

pSrc pSrc
Указатель на CImageList объект, являющийся целевым объектом операции копирования. A pointer to a CImageList object that is the target of the copy operation.

Возвращаемое значение Return Value

Ненулевое значение в случае успеха, иначе — 0. Nonzero if successful; otherwise zero.

Пример Example

CImageList:: Create CImageList::Create

Инициализирует список изображений и прикрепляет его к объекту CImageList . Initializes an image list and attaches it to a CImageList object.

Параметры Parameters

cx cx
Размеры каждого изображения (в пикселях). Dimensions of each image, in pixels.

CY cy
Размеры каждого изображения (в пикселях). Dimensions of each image, in pixels.

нфлагс nFlags
Указывает тип создаваемого списка изображений. Specifies the type of image list to create. Этот параметр может быть сочетанием следующих значений, но может включать только одно из ILC_COLOR значений. This parameter can be a combination of the following values, but it can include only one of the ILC_COLOR values.

Значение Value Значение Meaning
ILC_COLOR ILC_COLOR Используйте поведение по умолчанию, если не задан ни один из других флагов ILC_COLOR *. Use the default behavior if none of the other ILC_COLOR* flags is specified. Как правило, значение по умолчанию — ILC_COLOR4; но для старых драйверов дисплея значение по умолчанию — ILC_COLORDDB. Typically, the default is ILC_COLOR4; but for older display drivers, the default is ILC_COLORDDB.
ILC_COLOR4 ILC_COLOR4 Используйте 4-разрядное (16 цветовое) подразделы DIB в качестве точечного рисунка для списка изображений. Use a 4-bit (16 color) device-independent bitmap (DIB) section as the bitmap for the image list.
ILC_COLOR8 ILC_COLOR8 Используйте 8-разрядный раздел DIB. Use an 8-bit DIB section. Цвета, используемые для таблицы цветов, имеют те же цвета, что и палитра полутонов. The colors used for the color table are the same colors as the halftone palette.
ILC_COLOR16 ILC_COLOR16 Используйте 16-разрядный (32/64k цвет) раздел DIB. Use a 16-bit (32/64k color) DIB section.
ILC_COLOR24 ILC_COLOR24 Используйте 24-разрядный раздел DIB. Use a 24-bit DIB section.
ILC_COLOR32 ILC_COLOR32 Используйте 32-разрядный раздел DIB. Use a 32-bit DIB section.
ILC_COLORDDB ILC_COLORDDB Используйте зависимый от устройства точечный рисунок. Use a device-dependent bitmap.
ILC_MASK ILC_MASK Использует маску. Uses a mask. Список изображений содержит два точечных рисунка, один из которых является монохромным точечным рисунком, используемым в качестве маски. The image list contains two bitmaps, one of which is a monochrome bitmap used as a mask. Если это значение не включено, список изображений содержит только одно растровое изображение. If this value is not included, the image list contains only one bitmap. Дополнительные сведения о маскированных изображениях см. в разделе Рисование изображений из списка изображений . See Drawing Images from an Image List for additional information on masked images.

нинитиал nInitial
Число образов, изначально содержащихся в списке изображений. Number of images that the image list initially contains.

нгров nGrow
Число образов, по которым может увеличиваться список изображений, когда системе необходимо изменить размер списка, чтобы освободить место для новых изображений. Number of images by which the image list can grow when the system needs to resize the list to make room for new images. Этот параметр представляет число новых изображений, которые может содержать список изображений с измененным размером. This parameter represents the number of new images the resized image list can contain.

нбитмапид nBitmapID
Идентификаторы ресурсов растрового изображения, которые должны быть связаны со списком изображений. Resource IDs of the bitmap to be associated with the image list.

крмаск crMask
Цвет, используемый для создания маски. Color used to generate a mask. Каждый пиксел этого цвета в указанном растровом изображении изменяется на черный, а соответствующий бит в маске имеет значение 1. Each pixel of this color in the specified bitmap is changed to black, and the corresponding bit in the mask is set to one.

лпсзбитмапид lpszBitmapID
Строка, содержащая идентификаторы ресурсов для изображений. A string containing the resource IDs of the images.

imageList1 imagelist1
Ссылка на объект CImageList . A reference to a CImageList object.

nImage1 nImage1
Индекс первого существующего изображения. Index of the first existing image.

imagelist2 imagelist2
Ссылка на объект CImageList . A reference to a CImageList object.

nImage2 nImage2
Индекс второго существующего изображения. Index of the second existing image.

DX dx
Смещение оси x второго изображения по отношению к первому изображению в пикселях. Offset of the x-axis of the second image in relationship to the first image, in pixels.

DY dy
Смещение оси y второго изображения по отношению к первому изображению в пикселях. Offset of the y-axis of the second image in relationship to the first image, in pixels.

пимажелист pImageList
Указатель на объект CImageList . A pointer to a CImageList object.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Построение создается CImageList в два этапа. You construct a CImageList in two steps. Сначала вызовите конструктор, а затем вызовите метод Create , который создает список изображений и прикрепляет его CImageList к объекту. First, call the constructor and then call Create , which creates the image list and attaches it to the CImageList object.

Пример Example

CImageList::D Елетеимажелист CImageList::DeleteImageList

Вызовите эту функцию, чтобы удалить список изображений. Call this function to delete an image list.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Пример Example

CImageList::D Елететемпмап CImageList::DeleteTempMap

Вызывается автоматически CWinApp обработчиком времени простоя, DeleteTempMap удаляет все временные CImageList объекты, созданные FromHandle, но не уничтожает дескрипторы ( hImageList ), ImageList временно связанные с объект. Called automatically by the CWinApp idle-time handler, DeleteTempMap deletes any temporary CImageList objects created by FromHandle, but does not destroy any handles ( hImageList ) temporarily associated with the ImageList objects.

Пример Example

CImageList::D етач CImageList::Detach

Вызовите эту функцию, чтобы отсоединить объект списка изображений CImageList от объекта. Call this function to detach an image list object from a CImageList object.

Возвращаемое значение Return Value

Маркер объекта списка изображений. A handle to an image list object.

Примечания Remarks

Эта функция возвращает маркер объекта списка изображений. This function returns a handle to the image list object.

Пример Example

CImageList::D Ражентер CImageList::DragEnter

Во время операции перетаскивания фиксирует обновления в окне, заданном параметром пвндлокк , и отображает изображение перетаскивания в позиции, указанной параметром Point. During a drag operation, locks updates to the window specified by pWndLock and displays the drag image at the position specified by point.

Параметры Parameters

пвндлокк pWndLock
Указатель на окно, которому принадлежит изображение перетаскивания. Pointer to the window that owns the drag image.

point point
Расположение, в котором отображается изображение перетаскивания. Position at which to display the drag image. Координаты задаются относительно левого верхнего угла окна (а не клиентской области). Coordinates are relative to the upper left corner of the window (not the client area).

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Координаты задаются относительно левого верхнего угла окна, поэтому при указании координат необходимо компенсировать ширину элементов окна, таких как границы, заголовок и строка меню. The coordinates are relative to the window’s upper left corner, so you must compensate for the widths of window elements, such as the border, title bar, and menu bar, when specifying the coordinates.

Если пвндлокк имеет значение null, эта функция рисует изображение в контексте отображения, связанном с окном рабочего стола, а координаты задаются относительно левого верхнего угла экрана. If pWndLock is NULL, this function draws the image in the display context associated with the desktop window, and coordinates are relative to the upper left corner of the screen.

Эта функция блокирует все остальные обновления в заданном окне во время операции перетаскивания. This function locks all other updates to the given window during the drag operation. Если во время операции перетаскивания необходимо выполнить какие-либо действия, такие как выделение целевого объекта для операции перетаскивания, можно временно скрыть Перетаскивание изображения с помощью функции CImageList::D раглеаве . If you need to do any drawing during a drag operation, such as highlighting the target of a drag-and-drop operation, you can temporarily hide the dragged image by using the CImageList::DragLeave function.

Пример Example

CImageList::D Раглеаве CImageList::DragLeave

Разблокирует окно, заданное параметром пвндлокк , и скрывает изображение перетаскивания, позволяя обновлять окно. Unlocks the window specified by pWndLock and hides the drag image, allowing the window to be updated.

Параметры Parameters

пвндлокк pWndLock
Указатель на окно, которому принадлежит изображение перетаскивания. Pointer to the window that owns the drag image.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Пример Example

CImageList::D Рагмове CImageList::DragMove

Вызовите эту функцию, чтобы переместить изображение, которое перетаскивается во время операции перетаскивания. Call this function to move the image that is being dragged during a drag-and-drop operation.

Параметры Parameters

pt pt
Новое расположение перетаскивания. New drag position.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Эта функция обычно вызывается в ответ на сообщение WM_MOUSEMOVE. This function is typically called in response to a WM_MOUSEMOVE message. Чтобы начать операцию перетаскивания, используйте BeginDrag функцию-член. To begin a drag operation, use the BeginDrag member function.

Пример Example

CImageList::D Рагшовнолокк CImageList::DragShowNolock

Показывает или скрывает изображение перетаскивания во время операции перетаскивания без блокировки окна. Shows or hides the drag image during a drag operation, without locking the window.

Параметры Parameters

bShow bShow
Указывает, должно ли отображаться изображение перетаскивания. Specifies whether the drag image is to be shown.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Функция CImageList::D ражентер блокирует все обновления окна во время операции перетаскивания. The CImageList::DragEnter function locks all updates to the window during a drag operation. Однако эта функция не блокирует окно. This function, however, does not lock the window.

CImageList::D RAW CImageList::Draw

Вызовите эту функцию, чтобы нарисовать изображение, которое перетаскивается во время операции перетаскивания. Call this function to draw the image that is being dragged during a drag-and-drop operation.

Параметры Parameters

pDC pDC
Указатель на контекст целевого устройства. Pointer to the destination device context.

нимаже nImage
Отсчитываемый от нуля индекс изображения для рисования. Zero-based index of the image to draw.

pt pt
Расположение для рисования в указанном контексте устройства. Location at which to draw within the specified device context.

нстиле nStyle
Флаг, указывающий стиль отображения. Flag specifying the drawing style. Это может быть одно или несколько из следующих значений: It can be one or more of these values:

Значение Value Значение Meaning
ILD_BLEND25, ILD_FOCUS ILD_BLEND25, ILD_FOCUS Рисует изображение, смешивание 25% с цветом выделения системы. Draws the image, blending 25 percent with the system highlight color. Это значение не действует, если список изображений не содержит маску. This value has no effect if the image list does not contain a mask.
ILD_BLEND50, ILD_SELECTED, ILD_BLEND ILD_BLEND50, ILD_SELECTED, ILD_BLEND Рисует изображение, смешивание 50 процентов с цветом выделения системы. Draws the image, blending 50 percent with the system highlight color. Это значение не действует, если список изображений не содержит маску. This value has no effect if the image list does not contain a mask.
ILD_MASK ILD_MASK Рисует маску. Draws the mask.
ILD_NORMAL ILD_NORMAL Рисует изображение, используя цвет фона для списка изображений. Draws the image using the background color for the image list. Если цвет фона является значением CLR_NONE, изображение прозрачно рисуется с помощью маски. If the background color is the CLR_NONE value, the image is drawn transparently using the mask.
ILD_TRANSPARENT ILD_TRANSPARENT Рисует изображение прозрачно с помощью маски независимо от цвета фона. Draws the image transparently using the mask, regardless of the background color.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Пример Example

CImageList::D Равекс CImageList::DrawEx

Рисует элемент списка изображений в указанном контексте устройства. Draws an image list item in the specified device context.

Параметры Parameters

pDC pDC
Указатель на контекст целевого устройства. Pointer to the destination device context.

нимаже nImage
Отсчитываемый от нуля индекс изображения для рисования. Zero-based index of the image to draw.

pt pt
Расположение для рисования в указанном контексте устройства. Location at which to draw within the specified device context.

SZ sz
Размер части изображения для рисования относительно левого верхнего угла изображения. Size of the portion of the image to draw relative to the upper-left corner of the image. См. сведения о DX и dy в ImageList_DrawEx в Windows SDK. See dx and dy in ImageList_DrawEx in the Windows SDK.

клрбк clrBk
Цвет фона изображения. Background color of the image. См. раздел ргббк в ImageList_DrawEx в Windows SDK. See rgbBk in ImageList_DrawEx in the Windows SDK.

клрфг clrFg
Цвет переднего плана изображения. Foreground color of the image. См. раздел ргбфг в ImageList_DrawEx в Windows SDK. See rgbFg in ImageList_DrawEx in the Windows SDK.

нстиле nStyle
Флаг, указывающий стиль отображения. Flag specifying the drawing style. См. раздел фстиле в ImageList_DrawEx в Windows SDK. See fStyle in ImageList_DrawEx in the Windows SDK.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Функция использует указанный стиль рисования и смешивает изображение с указанным цветом. The function uses the specified drawing style and blends the image with the specified color.

Пример Example

CImageList::D Равиндирект CImageList::DrawIndirect

Вызовите эту функцию члена, чтобы нарисовать изображение из списка изображений. Call this member function to draw an image from an image list.

Параметры Parameters

пимлдп pimldp
Указатель на структуру имажелистдравпарамс , содержащую сведения об операции рисования. A pointer to an IMAGELISTDRAWPARAMS structure that contains information about the draw operation.

pDC pDC
Указатель на контекст целевого устройства. A pointer to the destination device context. Этот объект CDC необходимо удалить по завершении с ним. You must delete this CDC object when you are done with it.

нимаже nImage
Отсчитываемый от нуля индекс изображения, которое необходимо прорисовать. The zero-based index of the image to be drawn.

pt pt
Структура точек , содержащая координаты x и y, где будет нарисован изображение. A POINT structure containing the x- and y- coordinates where the image will be drawn.

SZ sz
Структура размера , указывающая размер изображения для рисования. A SIZE structure indicating the size of the image to be drawn.

пторигин ptOrigin
Структура точек , содержащая координаты x и y, указывающие верхний левый угол операции рисования относительно самого изображения. A POINT structure containing the x- and y-coordinates specifying the upper left corner of the drawing operation with respect to the image itself. Пикселы изображения, расположенные слева от координаты x и над координатой y, не рисуются. Pixels of the image that are to the left of the x-coordinate and above the y-coordinate are not drawn.

фстиле fStyle
Флаг, указывающий стиль рисования и, при необходимости, изображение оверлея. Flag specifying the drawing style and, optionally, the overlay image. Сведения о наложенном изображении см. в разделе «Примечания». See the Remarks section for information on the overlay image. Реализация MFC по умолчанию ILD_NORMAL рисует изображение, используя цвет фона для списка изображений. The MFC default implementation, ILD_NORMAL, draws the image using the background color for the image list. Если цвет фона является значением CLR_NONE, изображение прозрачно рисуется с помощью маски. If the background color is the CLR_NONE value, the image is drawn transparently using a mask.

Другие возможные стили описаны в элементе фстиле структуры имажелистдравпарамс . Other possible styles are described under the fStyle member of the IMAGELISTDRAWPARAMS structure.

двроп dwRop
Значение, указывающее код точечной операции. Value specifying a raster-operation code. Эти коды определяют, как данные цвета для исходного прямоугольника будут объединены с данными цвета для прямоугольника назначения, чтобы получить окончательный цвет. These codes define how the color data for the source rectangle will be combined with the color data for the destination rectangle to achieve the final color. Реализация MFC по умолчанию СРККОПИ копирует исходный прямоугольник непосредственно в прямоугольник назначения. MFC’s default implementation, SRCCOPY, copies the source rectangle directly to the destination rectangle. Этот параметр пропускается, если параметр фстиле не включает флаг ILD_ROP. This parameter is ignored if the fStyle parameter does not include the ILD_ROP flag.

Другие возможные значения описаны в элементе двроп структуры имажелистдравпарамс . Other possible values are described under the dwRop member of the IMAGELISTDRAWPARAMS structure.

ргббакк rgbBack
Цвет фона изображения по умолчанию CLR_DEFAULT. The image background color, by default CLR_DEFAULT. Этот параметр может быть значением RGB, определенным приложением, или одним из следующих значений: This parameter can be an application-defined RGB value or one of the following values:

Значение Value Значение Meaning
CLR_DEFAULT CLR_DEFAULT Цвет фона по умолчанию. Default background color. Изображение отображается с помощью цвета фона списка изображений. The image is drawn using the image list background color.
CLR_NONE CLR_NONE Цвет фона отсутствует. No background color. Изображение прозрачно рисуется. The image is drawn transparently.

ргбфоре rgbFore
Цвет переднего плана изображения по умолчанию CLR_DEFAULT. Image foreground color, by default CLR_DEFAULT. Этот параметр может быть значением RGB, определенным приложением, или одним из следующих значений: This parameter can be an application-defined RGB value or one of the following values:

Значение Value Значение Meaning
CLR_DEFAULT CLR_DEFAULT Цвет переднего плана по умолчанию. Default foreground color. Изображение отображается с использованием цвета выделения системы в качестве цвета переднего плана. The image is drawn using the system highlight color as the foreground color.
CLR_NONE CLR_NONE Нет цвета смешения. No blend color. Изображение смешивается с цветом контекста целевого устройства. The image is blended with the color of the destination device context.

Этот параметр используется только в том случае, если фстиле включает флаг ILD_BLEND25 или ILD_BLEND50. This parameter is used only if fStyle includes the ILD_BLEND25 or ILD_BLEND50 flag.

фстате fState
Флаг, указывающий состояние рисования. Flag specifying the drawing state. Этот элемент может содержать один или несколько флагов состояния списка изображений. This member can contain one or more image list state flags.

Frame Frame
Влияет на поведение эффектов насыщенности и альфа-смешения. Affects the behavior of saturate and alpha-blending effects.

При использовании с ILS_SATURATE этот элемент содержит значение, которое добавляется к каждому компоненту цвета Triplet RGB для каждого пикселя в значке. When used with ILS_SATURATE, this member holds the value that is added to each color component of the RGB triplet for each pixel in the icon.

При использовании с ILS_APLHA этот элемент содержит значение для альфа-канала. When used with ILS_APLHA, this member holds the value for the alpha channel. Это значение может быть от 0 до 255, при этом 0 будет полностью прозрачным, а 255 — полностью непрозрачным. This value can be from 0 to 255, with 0 being completely transparent, and 255 being completely opaque.

креффект crEffect
Значение COLORREF , используемое для эффектов свечения и тени. A COLORREF value used for glow and shadow effects.

Возвращаемое значение Return Value

Значение TRUE, если изображение успешно рисуется; в противном случае — FALSE. TRUE if the image is successfully drawn; otherwise FALSE.

Примечания Remarks

Используйте первую версию, если хотите самостоятельно заполнить структуру Win32. Use the first version if you want to fill the Win32 structure yourself. Используйте вторую версию, если требуется использовать один или несколько аргументов MFC по умолчанию или не управлять структурой. Use the second version if you want to take advantage of one or more of MFC’s default arguments, or avoid managing the structure.

Изображение оверлея — это изображение, которое рисуется поверх основного изображения, указанного в этой функции-члене параметром Нимаже . An overlay image is an image that is drawn on top of the primary image, specified in this member function by the nImage parameter. Нарисуйте маску оверлея с помощью функции-члена Draw с индексом оверлея, заданным с помощью макроса индекстуверлаймаск . Draw an overlay mask by using the Draw member function with the one-based index of the overlay mask specified by using the INDEXTOOVERLAYMASK macro.

Пример Example

CImageList:: Енддраг CImageList::EndDrag

Вызовите эту функцию для завершения операции перетаскивания. Call this function to end a drag operation.

Примечания Remarks

Чтобы начать операцию перетаскивания, используйте BeginDrag функцию-член. To begin a drag operation, use the BeginDrag member function.

Пример Example

CImageList:: Екстрактикон CImageList::ExtractIcon

Вызовите эту функцию, чтобы создать значок на основе изображения и связанной с ним маски в списке изображений. Call this function to create an icon based on an image and its related mask in an image list.

Параметры Parameters

нимаже nImage
Отсчитываемый от нуля индекс изображения. Zero-based index of the image.

Возвращаемое значение Return Value

Маркер значка в случае успеха; в противном случае — NULL. Handle of the icon if successful; otherwise NULL.

Примечания Remarks

Этот метод зависит от поведения макроса ImageList_ExtractIcon для создания значка. This method relies on the behavior of the ImageList_ExtractIcon macro to create the icon. Дополнительные сведения о создании и очистке значков см. в макросе ImageList_ExtractIcon . Refer to the ImageList_ExtractIcon macro for more information on icon creation and cleanup.

Пример Example

CImageList:: FromHandle CImageList::FromHandle

Возвращает указатель на CImageList объект при наличии маркера для списка изображений. Returns a pointer to a CImageList object when given a handle to an image list.

Параметры Parameters

hImageList hImageList
Задает список изображений. Specifies the image list.

Возвращаемое значение Return Value

Указатель на CImageList объект в случае успеха; в противном случае — null. A pointer to a CImageList object if successful; otherwise NULL.

Примечания Remarks

Если объект не присоединен к обработчику, создается и подключается временный CImageList . CImageList If a CImageList is not already attached to the handle, a temporary CImageList object is created and attached. Этот временный CImageList объект действителен только до тех пор, пока приложение не найдет время простоя в цикле событий, во время которого все временные объекты будут удалены. This temporary CImageList object is valid only until the next time the application has idle time in its event loop, at which time all temporary objects are deleted.

Пример Example

CImageList:: Фромхандлеперманент CImageList::FromHandlePermanent

Возвращает указатель на CImageList объект при наличии маркера для списка изображений. Returns a pointer to a CImageList object when given a handle to an image list.

Параметры Parameters

hImageList hImageList
Задает список изображений. Specifies the image list.

Возвращаемое значение Return Value

Указатель на CImageList объект в случае успеха; в противном случае — null. A pointer to a CImageList object if successful; otherwise NULL.

Примечания Remarks

CImageList Если объект не присоединен к маркеру, возвращается значение null. If a CImageList object is not attached to the handle, NULL is returned.

Пример Example

CImageList:: Жетбкколор CImageList::GetBkColor

Вызовите эту функцию, чтобы получить текущий цвет фона для списка изображений. Call this function to retrieve the current background color for an image list.

Возвращаемое значение Return Value

Значение цвета RGB цвета фона CImageList объекта. The RGB color value of the CImageList object background color.

Пример Example

CImageList:: Жетдрагимаже CImageList::GetDragImage

Возвращает временный список изображений, используемый для перетаскивания. Gets the temporary image list that is used for dragging.

Параметры Parameters

лппоинт lpPoint
Адрес структуры точек , которая получает текущую позицию перетаскивания. Address of a POINT structure that receives the current drag position.

лппоинсотспот lpPointHotSpot
POINT Адрес структуры, получающей смещение изображения перетаскивания относительно позиции перетаскивания. Address of a POINT structure that receives the offset of the drag image relative to the drag position.

Возвращаемое значение Return Value

В случае успеха указатель на временный список изображений, используемый для перетаскивания; в противном случае значение NULL. If successful, a pointer to the temporary image list that is used for dragging; otherwise, NULL.

CImageList:: Жетимажекаунт CImageList::GetImageCount

Вызовите эту функцию, чтобы получить количество изображений в списке изображений. Call this function to retrieve the number of images in an image list.

Возвращаемое значение Return Value

Количество образов. The number of images.

Пример Example

CImageList:: Жетимажеинфо CImageList::GetImageInfo

Вызовите эту функцию, чтобы получить сведения о изображении. Call this function to retrieve information about an image.

Параметры Parameters

нимаже nImage
Отсчитываемый от нуля индекс изображения. Zero-based index of the image.

пимажеинфо pImageInfo
Указатель на структуру имажеинфо , которая получает сведения об изображении. Pointer to an IMAGEINFO structure that receives information about the image. Сведения в этой структуре можно использовать для непосредственного управления точечными рисунками изображения. The information in this structure can be used to directly manipulate the bitmaps for the image.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

IMAGEINFO Структура содержит сведения о изображении в списке изображений. The IMAGEINFO structure contains information about an image in an image list.

CImageList:: Жетсафехандле CImageList::GetSafeHandle

Вызовите эту функцию, чтобы m_hImageList получить элемент данных. Call this function to retrieve the m_hImageList data member.

Возвращаемое значение Return Value

Маркер для присоединенного списка изображений; в противном случае значение NULL, если объект не присоединен. A handle to the attached image list; otherwise NULL if no object is attached.

Пример Example

CImageList:: m_hImageList CImageList::m_hImageList

Маркер списка изображений, прикрепленный к этому объекту. A handle of the image list attached to this object.

Примечания Remarks

Элемент m_hImageList данных является открытой переменной типа химажелист. The m_hImageList data member is a public variable of type HIMAGELIST.

Пример Example

CImageList:: operator ХИМАЖЕЛИСТ CImageList::operator HIMAGELIST

Этот оператор используется для получения присоединенного маркера CImageList объекта. Use this operator to get the attached handle of the CImageList object.

Возвращаемое значение Return Value

В случае успеха — обработчик списка изображений, представленный CImageList объектом; в противном случае — null. If successful, a handle to the image list represented by the CImageList object; otherwise NULL.

Примечания Remarks

Этот оператор является оператором приведения, который поддерживает прямое использование объекта ХИМАЖЕЛИСТ. This operator is a casting operator, which supports direct use of an HIMAGELIST object.

Пример Example

CImageList:: Read CImageList::Read

Эта функция вызывается для чтения списка изображений из архива. Call this function to read an image list from an archive.

Параметры Parameters

парчиве pArchive
Указатель на CArchive объект, из которого считывается список изображений. A pointer to a CArchive object from which the image list is to be read.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Пример Example

CImageList:: Remove CImageList::Remove

Вызовите эту функцию, чтобы удалить изображение из объекта списка изображений. Call this function to remove an image from an image list object.

Параметры Parameters

нимаже nImage
Отсчитываемый от нуля индекс удаляемого изображения. Zero-based index of the image to remove.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Все элементы, следующие за Нимаже , теперь перемещаются в одну и ту же позиции. All items following nImage now move down one position. Например, если список изображений содержит два элемента, удаление первого элемента приведет к тому, что оставшийся элемент будет находиться в первой позиции. For example, if an image list contains two items, deleting the first item will cause the remaining item to now be in the first position. Нимаже= 0 для элемента в первой позиции. nImage=0 for the item in the first position.

Пример Example

CImageList:: Replace CImageList::Replace

Вызовите эту функцию, чтобы заменить изображение в списке изображений новым изображением. Call this function to replace an image in an image list with a new image.

Параметры Parameters

нимаже nImage
Отсчитываемый от нуля индекс заменяемого изображения. Zero-based index of the image to replace.

пбмимаже pbmImage
Указатель на точечный рисунок, содержащий изображение. A pointer to the bitmap containing the image.

пбммаск pbmMask
Указатель на точечный рисунок, содержащий маску. A pointer to the bitmap containing the mask. Если в списке изображений не используется маска, этот параметр игнорируется. If no mask is used with the image list, this parameter is ignored.

hIcon hIcon
Маркер для значка, который содержит растровое изображение и маску для нового изображения. A handle to the icon that contains the bitmap and mask for the new image.

Возвращаемое значение Return Value

Версия, возвращающая BOOL, возвращает ненулевое значение в случае успеха. в противном случае — 0. The version returning BOOL returns nonzero if successful; otherwise 0.

Версия, возвращающая значение int , возвращает отсчитываемый от нуля индекс изображения в случае успеха. в противном случае — 1. The version returning int returns the zero-based index of the image if successful; otherwise — 1.

Примечания Remarks

Вызовите эту функцию члена после вызова сетимажекаунт , чтобы назначить новые допустимые изображения для номеров индекса изображения заполнителя. Call this member function after calling SetImageCount to assign the new, valid images to the placeholder image index numbers.

Пример Example

CImageList:: Сетбкколор CImageList::SetBkColor

Вызовите эту функцию, чтобы задать цвет фона для списка изображений. Call this function to set the background color for an image list.

Параметры Parameters

Кредит cr
Цвет фона для установки. Background color to set. Это может быть CLR_NONE. It can be CLR_NONE. В этом случае изображения прозрачно рисуются с помощью маски. In that case, images are drawn transparently using the mask.

Возвращаемое значение Return Value

Предыдущий цвет фона в случае успеха; в противном случае CLR_NONE. The previous background color if successful; otherwise CLR_NONE.

Пример Example

CImageList:: Сетдрагкурсоримаже CImageList::SetDragCursorImage

Создает новое изображение перетаскивания, комбинируя заданный рисунок (обычно это изображение курсора мыши) с текущим изображением перетаскивания. Creates a new drag image by combining the given image (typically a mouse cursor image) with the current drag image.

Параметры Parameters

ндраг nDrag
Индекс нового изображения, которое необходимо объединить с изображением перетаскивания. Index of the new image to be combined with the drag image.

псотспот ptHotSpot
Расположение активной точки в новом изображении. Position of the hot spot within the new image.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

Поскольку функции перетаскивания используют новый образ во время операции перетаскивания, следует использовать функцию Windows шовкурсор , чтобы скрыть фактический курсор мыши после вызова метода CImageList::SetDragCursorImage . Because the dragging functions use the new image during a drag operation, you should use the Windows ShowCursor function to hide the actual mouse cursor after calling CImageList::SetDragCursorImage . В противном случае система может иметь два курсора мыши в течение операции перетаскивания. Otherwise, the system may appear to have two mouse cursors for the duration of the drag operation.

CImageList:: Сетимажекаунт CImageList::SetImageCount

Вызовите эту функцию-член, чтобы сбросить количество изображений в CImageList объекте. Call this member function to reset the number of images in a CImageList object.

Параметры Parameters

уневкаунт uNewCount
Значение, указывающее новое общее число образов в списке изображений. The value specifying the new total number of images in the image list.

Возвращаемое значение Return Value

Ненулевое значение в случае успеха, иначе — 0. Nonzero if successful; otherwise zero.

Примечания Remarks

При вызове этой функции члена для увеличения количества изображений в списке изображений вызовите метод Replace для каждого дополнительного изображения, чтобы назначить новые индексы допустимым изображениям. If you call this member function to increase the number of images in the image list, then call Replace for each additional image to assign the new indexes to valid images. Если не назначить индексы допустимым изображениям, операции рисования, создающие новые образы, будут непредсказуемыми. If you fail to assign the indexes to valid images, draw operations that create the new images will be unpredictable.

При уменьшении размера списка изображений с помощью этой функции усеченные изображения освобождаются. If you decrease the size of an image list by using this function, the truncated images are freed.

Пример Example

CImageList:: Сетоверлайимаже CImageList::SetOverlayImage

Вызовите эту функцию, чтобы добавить Отсчитываемый от нуля индекс изображения в список изображений, которые будут использоваться в качестве масок наложения. Call this function to add the zero-based index of an image to the list of images to be used as overlay masks.

Параметры Parameters

нимаже nImage
Отсчитываемый от нуля индекс изображения, используемого в качестве маски оверлея. Zero-based index of the image to use as an overlay mask.

новерлай nOverlay
Индекс маски оверлея, отсчитываемый от единицы. One-based index of the overlay mask.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

Примечания Remarks

В список можно добавить до четырех индексов. Up to four indices can be added to the list.

Маска оверлея — это изображение, которое прозрачно рисуется над другим изображением. An overlay mask is an image drawn transparently over another image. Нарисуйте маску наложения для изображения с помощью функции-члена CImageList::D RAW с индексом оверлея, заданным с помощью макроса индекстуверлаймаск. Draw an overlay mask over an image by using the CImageList::Draw member function with the one-based index of the overlay mask specified by using the INDEXTOOVERLAYMASK macro.

Пример Example

CImageList:: Write CImageList::Write

Вызывайте эту функцию для записи объекта списка изображений в архив. Call this function to write an image list object to an archive.

Параметры Parameters

парчиве pArchive
Указатель на CArchive объект, в котором будет храниться список изображений. A pointer to a CArchive object in which the image list is to be stored.

Возвращаемое значение Return Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0. Nonzero if successful; otherwise 0.

imageinterlace

imageinterlace — Включение или выключение интерлейсинга

Описание

imageinterlace() переключает состояние бита интерлейсинга.

Если установить бит интерлейсинга, а изображение загрузить, как JPEG , это приведет к созданию прогрессивного JPEG .

Список параметров

Ресурс изображения, полученный одной из функций создания изображений, например, такой как imagecreatetruecolor() .

Если значение отлично от нуля, изображение будет разбито на чередующиеся строки, в противном случае бит интерлейсинга будет установлен в 0.

Возвращаемые значения

Возвращает 1, если бит интерлейсинга установлен, 0 в противном случае.

Примеры

Пример #1 Включение интерлейсинга, используя imageinterlace()

// Создание нового изображения
$im = imagecreatefromgif ( ‘php.gif’ );

// Включение интерлейсинга
imageinterlace ( $im , true );

Что такое код imageinterlace

imageinterlace — Enable or disable interlace

Description int imageinterlace ( resource image [, int interlace])

imageinterlace() turns the interlace bit on or off. If interlace is 1 the image will be interlaced, and if interlace is 0 the interlace bit is turned off.

If the interlace bit is set and the image is used as a JPEG image, the image is created as a progressive JPEG.

This function returns whether the interlace bit is set for the image.

Новые книги

В своем руководстве для владельцев малого и среднего бизнеса известный эксперт по прикладному маркетингу Джон Янч приводит простые, эффективные и бюджетные методы разработки и реализации маркетинговой стратегии с целью привлечения новых клиентов и повышения доходов.

На русском языке публикуется впервые.

imageinterlace

imageinterlace — включает/отключает interlace/чередование.

Описание

int imageinterlace (resource image [, int interlace])

imageinterlace() включает/отключает interlace-бит. Если interlace равен 1, изображение будет interlaced, а если 0 — interlace-бит будет выключен.

Если interlace-бит установлен и изображение используется как JPEG-изображение, изображение создаётся как progressive JPEG.

Эта функция возвращает interlace-бит изображения.

Илон Маск рекомендует:  Что такое код mb_http_output
Понравилась статья? Поделиться с друзьями:
Кодинг, CSS и SQL
Учебник РНР
НазадВперёд