SftTabs/DLL 6.5 - Tab Control

FreeGDIPlusImageLoadedFromResource

Deletes a GDI+ image obtained using SftTabs_LoadGDIPlusImageFromResource.

C

void SftTabs_FreeGDIPlusImageLoadedFromResource(LPVOID pGDIPlusImage);

Parameters

pGDIPlusImage

A Gdiplus::Image pointer to be deleted. This value is usually obtained from a preceding call to SftTabs_LoadGDIPlusImageFromResource.

Comments

Deletes a GDI+ image obtained using SftTabs_LoadGDIPlusImageFromResource.

This function is mainly intended for applications written using C. Because Gdiplus is C++ based, C applications don't readily have access to the Gdiplus::Image class and cannot use delete to free a GDI+ image object. Using SftTabs_FreeGDIPlusImageLoadedFromResource even C applications can use GDI+ images, without needing access to GDI+ itself.

The application retains ownership of the Gdiplus::Image pointer returned by SftTabs_FreeGDIPlusImageLoadedFromResource. Once the image is no longer needed, it can be released using SftTabs_FreeGDIPlusImageLoadedFromResource, which frees the associated memory.

Examples

C

                            Sft_SetPictureGDIPlusImage(&Tab.TabPicture, lpImage);
                        else if (ID == IDC_GDI_LOAD_HOT)
                            Sft_SetPictureGDIPlusImage(&Tab.TabPictureHot, lpImage);
                        else if (ID == IDC_GDI_LOAD_DISABLED)
                            Sft_SetPictureGDIPlusImage(&Tab.TabPictureDisabled, lpImage);
                        SftTabs_SetTabInfo(m_hwndMainTab, 0, &Tab);

                        if (ID == IDC_GDI_LOAD) {
                            SftTabs_FreeGDIPlusImageLoadedFromResource(m_lpGDIPlusImage); // delete the current image
                            m_lpGDIPlusImage = lpImage;
                        } else if (ID == IDC_GDI_LOAD_HOT) {
                            SftTabs_FreeGDIPlusImageLoadedFromResource(m_lpGDIPlusImageHot);
                            m_lpGDIPlusImageHot = lpImage;
                        } else if (ID == IDC_GDI_LOAD_DISABLED) {
                            SftTabs_FreeGDIPlusImageLoadedFromResource(m_lpGDIPlusImageDisabled);
                            m_lpGDIPlusImageDisabled = lpImage;

View Entire Sample Code

See Also C/C++ API | C++ Classes | Notifications