Funzioni di immagine
Windows GDI+ espone un'API flat costituita da circa 600 funzioni, implementate in Gdiplus.dll e dichiarate in Gdiplusflat.h. Le funzioni nell'API flat GDI+ sono incluse in una raccolta di circa 40 classi C++. È consigliabile non chiamare direttamente le funzioni nell'API flat. Ogni volta che si effettuano chiamate a GDI+, è necessario chiamare i metodi e le funzioni forniti dai wrapper C++. Il Servizio Supporto Tecnico Clienti Microsoft non fornirà supporto per il codice che chiama direttamente l'API flat. Per altre informazioni sull'uso di questi metodi wrapper, vedere API GDI+ Flat.
Le funzioni API flat seguenti vengono incluse nella classe Image C++.
Funzioni HatchBrush e metodi wrapper corrispondenti
| Funzione flat | Wrapper, metodo | Commenti |
|---|---|---|
| GpStatus WINGDIPAPI GdipLoadImageFromStream(IStream* stream, GpImage **image) |
Image::Image(IN IStream* stream, IN BOOL useEmbeddedColorManagement) | Crea un oggetto Image basato su un flusso. Questa funzione flat non usa Image Color Management (ICM). |
| GpStatus WINGDIPAPI GdipLoadImageFromFile(GDIPCONST WCHAR* filename, GpImage **image) |
Image::Image(IN const WCHAR* filename, IN BOOL useEmbeddedColorManagement) | Crea un oggetto Image basato su un file. Questa funzione flat non usa ICM. |
| GpStatus WINGDIPAPI GdipLoadImageFromStreamICM(IStream* stream, GpImage **image) |
Image::Image(IN IStream* stream, IN BOOL useEmbeddedColorManagement) | Crea un oggetto Image basato su un flusso. Questa funzione flat non usa ICM. |
| GpStatus WINGDIPAPI GdipLoadImageFromFileICM(GDIPCONST WCHAR* filename, GpImage **image) |
Image::Image(IN const WCHAR* filename, IN BOOL useEmbeddedColorManagement) | Crea un oggetto Image basato su un file. Questa funzione flat non usa ICM. |
| GpStatus WINGDIPAPI GdipCloneImage(GpImage *image, GpImage **cloneImage) |
Image* Image::Clone() | Crea un nuovo oggetto Image e lo inizializza con il contenuto dell'oggetto Image . |
| GpStatus WINGDIPAPI GdipDisposeImage(GpImage *image) |
Image::~Image() |
Rilascia le risorse utilizzate dall'oggetto Image . |
| GpStatus WINGDIPAPI GdipSaveImageToFile(GpImage *image, GDIPCONST WCHAR* filename, GDIPCONST CLSID* clsidEncoder, GDIPCONST EncoderParameters* encoderParams) |
Status Image::Save( IN const WCHAR* filename, IN const CLSID* clsidEncoder, IN const EncoderParameters *encoderParams ) | Salva questa immagine in un file. |
| GpStatus WINGDIPAPI GdipSaveImageToStream(GpImage *image, IStream* stream, GDIPCONST CLSID* clsidEncoder, GDIPCONST EncoderParameters* encoderParams) |
Status Image::Save( IN IStream* stream, IN const CLSID* clsidEncoder, IN const EncoderParameters *encoderParams ) | Salva l'immagine in un flusso. |
| GpStatus WINGDIPAPI GdipSaveAdd(GpImage *image, GDIPCONST EncoderParameters* encoderParams) |
Status Image::SaveAdd( IN const EncoderParameters *encoderParams ) | Aggiunge un frame a un file o a un flusso specificato in una chiamata precedente al metodo Save. Usare questo metodo per salvare i fotogrammi selezionati da un'immagine a più fotogrammi in un'altra immagine a più fotogrammi. |
| GpStatus WINGDIPAPI GdipSaveAddImage(GpImage *image, GpImage* newImage, GDIPCONST EncoderParameters* encoderParams) |
Status Image::SaveAdd( IN Image* newImage, IN const EncoderParameters *encoderParams ) | Aggiunge un frame a un file o a un flusso specificato in una chiamata precedente al metodo Save. |
| GpStatus WINGDIPAPI GdipGetImageGraphicsContext(GpImage *image, GpGraphics **graphics) |
Graphics::Graphics(IN Image* image) | Crea un oggetto Graphics associato a un oggetto Image. |
| GpStatus WINGDIPAPI GdipGetImageBounds(GpImage *image, GpRectF *srcRect, GpUnit *srcUnit) |
Immagine di stato::GetBounds( OUT RectF *srcRect, OUT Unit *srcUnit ) | Ottiene il rettangolo di delimitazione per questa immagine. |
| GpStatus WINGDIPAPI GdipGetImageDimension(GpImage *image, REAL *width, REAL *height) |
Status Image::GetPhysicalDimension( OUT SizeF* size ) | Ottiene la larghezza e l'altezza di questa immagine. Nella funzione flat i parametri width e height corrispondono al parametro size nel metodo wrapper. |
| GpStatus WINGDIPAPI GdipGetImageType(GpImage *image, ImageType *type) |
ImageType Image::GetType() const | Ottiene il tipo (bitmap o metafile) dell'oggetto Image. |
| GpStatus WINGDIPAPI GdipGetImageWidth(GpImage *image, UINT *width) |
UINT Image::GetWidth() | Ottiene la larghezza, in pixel, dell'immagine. |
| GpStatus WINGDIPAPI GdipGetImageHeight(GpImage *image, UINT *height) |
UINT Image::GetHeight() | Ottiene l'altezza dell'immagine, in pixel, dell'immagine. |
| GpStatus WINGDIPAPI GdipGetImageHorizontalResolution(GpImage *image, REAL *resolution) |
REAL Image::GetHorizontalResolution() | Ottiene la risoluzione orizzontale, espressa in punti per pollice, di questa immagine. |
| GpStatus WINGDIPAPI GdipGetImageVerticalResolution(GpImage *image, REAL *resolution) |
REAL Image::GetVerticalResolution() | Ottiene la risoluzione verticale, espressa in punti per pollice, di questa immagine. |
| GpStatus WINGDIPAPI GdipGetImageFlags(GpImage *image, UINT *flags) |
UINT Image::GetFlags() | Ottiene un set di flag che indicano determinati attributi dell'oggetto Image . |
| GpStatus WINGDIPAPI GdipGetImageRawFormat(GpImage *image, GUID *format) |
Status Image::GetRawFormat(OUT GUID *format) | Ottiene un identificatore univoco globale (GUID) che identifica il formato dell'oggetto Image. I GUID che identificano i vari formati di file sono definiti in Gdiplusimaging.h. |
| GpStatus WINGDIPAPI GdipGetImagePixelFormat(GpImage *image, PixelFormat *format) |
PixelFormat Image::GetPixelFormat() | Ottiene il formato pixel dell'oggetto Image. |
| GpStatus WINGDIPAPI GdipGetImageThumbnail(GpImage *image, UINT thumbWidth, UINT thumbHeight, GpImage **thumbImage, GetThumbnailImageAbort callback, VOID * callbackData) |
Image* Image::GetThumbnailImage( IN UINT thumbWidth, IN UINT thumbHeight, IN GetThumbnailImageAbort callback, IN VOID* callbackData ) | Ottiene un'immagine di anteprima da questo oggetto Image . |
| GpStatus WINGDIPAPI GdipGetEncoderParameterListSize(GpImage *image, GDIPCONST CLSID* clsidEncoder, UINT* size) |
UINT Image::GetEncoderParameterListSize( IN const CLSID* clsidEncoder ) | Ottiene le dimensioni, in byte, dell'elenco di parametri per un codificatore di immagini specificato. |
| GpStatus WINGDIPAPI GdipGetEncoderParameterList(GpImage *image, GDIPCONST CLSID* clsidEncoder, UINT size, EncoderParameters* buffer) |
Status Image::GetEncoderParameterList( IN const CLSID* clsidEncoder, IN UINT size, OUT EncoderParameters* buffer ) | Ottiene un elenco dei parametri supportati da un codificatore di immagini specificato. |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsCount(GpImage* image, UINT* count) |
UINT Image::GetFrameDimensionsCount() | Ottiene il numero di dimensioni cornice nell'oggetto Image. |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsList(GpImage* image, GUID* dimensionIDs, UINT count) |
Status Image::GetFrameDimensionsList( OUT GUID* dimensionIDs, IN UINT count ) | Ottiene gli identificatori per le dimensioni cornice dell'oggetto Image. |
| GpStatus WINGDIPAPI GdipImageGetFrameCount(GpImage *image, GDIPCONST GUID* dimensionID, UINT* count) |
UINT Image::GetFrameCount( IN const GUID* dimensionID ) | Ottiene il numero di fotogrammi in una dimensione specificata dell'oggetto Image. |
| GpStatus WINGDIPAPI GdipImageSelectActiveFrame(GpImage *image, GDIPCONST GUID* dimensionID, UINT frameIndex) |
Status Image::SelectActiveFrame( IN const GUID *dimensionID, IN UINT frameIndex ) | Seleziona la cornice in questo oggetto Image specificata da una dimensione e da un indice. |
| GpStatus WINGDIPAPI GdipImageRotateFlip(GpImage *image, RotateFlipType rfType) |
Status Image::RotateFlip( IN RotateFlipType rotateFlipType ) | Ruota e capovolge questa immagine. |
| GpStatus WINGDIPAPI GdipGetImagePalette(GpImage *image, ColorPalette *palette, INT size) |
Status Image::GetPalette( OUT ColorPalette *palette, INT size ) | Ottiene l'oggetto ColorPalette dell'oggetto Image. |
| GpStatus WINGDIPAPI GdipSetImagePalette(GpImage *image, GDIPCONST ColorPalette *palette) |
Status Image::SetPalette( IN const ColorPalette *palette ) | Imposta la tavolozza dei colori dell'oggetto Image . |
| GpStatus WINGDIPAPI GdipGetImagePaletteSize(GpImage *image, INT *size) |
INT Image::GetPaletteSize() | Ottiene le dimensioni, in byte, della tavolozza dei colori dell'oggetto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyCount(GpImage *image, UINT* numOfProperty) |
UINT Image::GetPropertyCount() | Ottiene il formato pixel dell'oggetto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyIdList(GpImage *image, UINT numOfProperty, PROPID* list) |
Status Image::GetPropertyIdList( IN UINT numOfProperty, OUT PROPID* list ) | Ottiene un elenco degli identificatori di proprietà utilizzati nei metadati di questo oggetto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyItemSize(GpImage *image, PROPID propId, UINT* size) |
UINT Image::GetPropertyItemSize( IN PROPID propId ) | Ottiene le dimensioni, in byte, di un elemento di proprietà specificato dell'oggetto Image . |
| GpStatus WINGDIPAPI GdipGetPropertyItem(GpImage *image, PROPID propId,UINT propSize, PropertyItem* buffer) |
Status Image::GetPropertyItem( IN PROPID propId, IN UINT propSize, OUT PropertyItem* buffer ) | Ottiene un elemento di proprietà specificato (parte dei metadati) da questo oggetto Image . |
| GpStatus WINGDIPAPI GdipGetPropertySize(GpImage *image, UINT* totalBufferSize, UINT* numProperties) |
Status Image::GetPropertySize( OUT UINT* totalBufferSize, OUT UINT* numProperties ) | Ottiene la dimensione totale, in byte, di tutti gli elementi della proprietà archiviati in questo oggetto Image . Questo metodo ottiene anche il numero di elementi della proprietà archiviati in questo oggetto Image . |
| GpStatus WINGDIPAPI GdipGetAllPropertyItems(GpImage *image, UINT totalBufferSize, UINT numProperties, PropertyItem* allItems) |
Status Image::GetAllPropertyItems( IN UINT totalBufferSize, IN UINT numProperties, OUT PropertyItem* allItems ) | Ottiene tutti gli elementi della proprietà (metadati) archiviati in questo oggetto Image . |
| GpStatus WINGDIPAPI GdipRemovePropertyItem(GpImage *image, PROPID propId) |
Status Image::RemovePropertyItem( IN PROPID propId ) | Rimuove un elemento della proprietà (parte di metadati) da questo oggetto Image . |
| GpStatus WINGDIPAPI GdipSetPropertyItem(GpImage *image, GDIPCONST PropertyItem* item) |
Immagine di stato::SetPropertyItem | Imposta un elemento di proprietà (parte di metadati) per questo oggetto Image . Se l'elemento esiste già, il relativo contenuto viene aggiornato; in caso contrario, viene aggiunto un nuovo elemento. |
| GpStatus WINGDIPAPI GdipFindFirstImageItem(GpImage *image, ImageItemData* item) |
Status Image::FindFirstItem( IN ImageItemData* item ) | Recupera la descrizione e le dimensioni dei dati del primo elemento di metadati in questo oggetto Image . |
| GpStatus WINGDIPAPI GdipFindNextImageItem(GpImage *image, ImageItemData* item) |
Status Image::FindNextItem( IN ImageItemData* item ) | Recupera la descrizione e le dimensioni dei dati dell'elemento di metadati successivo in questo oggetto Image . Questo metodo viene usato insieme al metodo Image::FindFirstItem per enumerare gli elementi di metadati archiviati in questo oggettoIm Imageage. |
| GpStatus WINGDIPAPI GdipGetImageItemData(GpImage *image, ImageItemData* item) |
Status Image::GetItemData( IN ImageItemData* item ) | Ottiene un frammento di metadati da questo oggetto Image . |
| GpStatus WINGDIPAPI GdipImageSetAbort(GpImage *pImage, GdiplusAbort *pIAbort) |
Immagine di stato::SetAbort( GdiplusAbort *pIAbort ) | Imposta l'oggetto il cui metodo Abort viene chiamato periodicamente durante l'operazione di rendering dispendiosa in termini di tempo. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlus(const GpGraphics* refGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile) |
Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description ) | Converte questo oggetto Metafile nel formato EMF+. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlusToFile(const GpGraphics* refGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, const WCHAR* filename, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile) |
Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, const WCHAR* filename, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description ) | Converte questo oggetto Metafile nel formato EMF+. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlusToStream(const GpGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, IStream* stream, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile) |
Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, IStream* stream, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description ) | Converte questo oggetto Metafile nel formato EMF+. |
| GpStatus WINGDIPAPI GdipImageForceValidation(GpImage *image) |
Non chiamato dai metodi wrapper. |
Questa funzione forza la convalida dell'immagine. |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per