Klasa CPictureHolder

Implementuje właściwość Obraz, która umożliwia użytkownikowi wyświetlanie obrazu w kontrolce.

Składnia

class CPictureHolder

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CPictureHolder::CPictureHolder	CPictureHolder Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CPictureHolder::CreateEmpty	Tworzy pusty CPictureHolder obiekt.
CPictureHolder::CreateFromBitmap	Tworzy CPictureHolder obiekt na podstawie mapy bitowej.
CPictureHolder::CreateFromIcon	Tworzy CPictureHolder obiekt na podstawie ikony.
CPictureHolder::CreateFromMetafile	Tworzy CPictureHolder obiekt na podstawie metapliku.
CPictureHolder::GetDisplayString	Pobiera ciąg wyświetlany w przeglądarce właściwości kontenera sterowania.
CPictureHolder::GetPictureDispatch	CPictureHolder Zwraca interfejs obiektuIDispatch.
CPictureHolder::GetType	Informuje, czy CPictureHolder obiekt jest mapą bitową, metaplikiem, czy ikoną.
CPictureHolder::Render	Renderuje obraz.
CPictureHolder::SetPictureDispatch	CPictureHolder Ustawia interfejs obiektuIDispatch.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
CPictureHolder::m_pPict	Wskaźnik do obiektu obrazu.

Uwagi

CPictureHolder nie ma klasy bazowej.

Za pomocą właściwości stock Picture deweloper może określić mapę bitową, ikonę lub metaplik do wyświetlania.

Aby uzyskać informacje na temat tworzenia właściwości obrazu niestandardowego, zobacz artykuł Kontrolki ActiveX MFC: używanie obrazów w kontrolce ActiveX.

Hierarchia dziedziczenia

CPictureHolder

Wymagania

Nagłówek: afxctl.h

CPictureHolder::CPictureHolder

CPictureHolder Tworzy obiekt.

CPictureHolder();

CPictureHolder::CreateEmpty

Tworzy pusty CPictureHolder obiekt i łączy go z interfejsem IPicture .

BOOL CreateEmpty();

Wartość zwracana

Nonzero, jeśli obiekt został pomyślnie utworzony; w przeciwnym razie 0.

CPictureHolder::CreateFromBitmap

Używa mapy bitowej do inicjowania obiektu obrazu w obiekcie CPictureHolder.

BOOL CreateFromBitmap(
    UINT idResource);

BOOL CreateFromBitmap(
    CBitmap* pBitmap,
    CPalette* pPal = NULL,
    BOOL bTransferOwnership = TRUE);

BOOL CreateFromBitmap(
    HBITMAP hbm,
    HPALETTE hpal = NULL,
    BOOL bTransferOwnership = FALSE);

Parametry

idResource
Identyfikator zasobu mapy bitowej.

Mapa pBit
Wskaźnik do obiektu CBitmap .

pPal
Wskaźnik do obiektu CPalette .

Btransferownership
Wskazuje, czy obiekt obrazu przejmie na własność obiekty mapy bitowej i palety.

Hbm
Dojście do mapy bitowej, z której CPictureHolder tworzony jest obiekt.

hpal
Uchwyt do palety używanej do renderowania mapy bitowej.

Wartość zwracana

Nonzero, jeśli obiekt został pomyślnie utworzony; w przeciwnym razie 0.

Uwagi

Jeśli parametr bTransferOwnership ma wartość TRUE, obiekt wywołujący nie powinien używać obiektu mapy bitowej ani palety w żaden sposób po powrocie tego wywołania. Jeśli parametr bTransferOwnership ma wartość FALSE, obiekt wywołujący jest odpowiedzialny za zapewnienie, że obiekty mapy bitowej i palety pozostają prawidłowe przez cały okres istnienia obiektu obrazu.

CPictureHolder::CreateFromIcon

Używa ikony do inicjowania obiektu obrazu w obiekcie CPictureHolder.

BOOL CreateFromIcon(
    UINT idResource);

BOOL CreateFromIcon(
    HICON hIcon,
    BOOL bTransferOwnership = FALSE);

Parametry

idResource
Identyfikator zasobu mapy bitowej.

hIcon
Dojmij do ikony, z której CPictureHolder jest tworzony obiekt.

Btransferownership
Wskazuje, czy obiekt obrazu przejmie własność obiektu ikony.

Wartość zwracana

Nonzero, jeśli obiekt został pomyślnie utworzony; w przeciwnym razie 0.

Uwagi

Jeśli parametr bTransferOwnership ma wartość TRUE, obiekt wywołujący nie powinien używać obiektu ikony w żaden sposób po powrocie tego wywołania. Jeśli parametr bTransferOwnership ma wartość FALSE, obiekt wywołujący jest odpowiedzialny za zapewnienie, że obiekt ikony pozostaje ważny przez okres istnienia obiektu obrazu.

CPictureHolder::CreateFromMetafile

Używa metapliku do inicjowania obiektu obrazu w obiekcie CPictureHolder.

BOOL CreateFromMetafile(
    HMETAFILE hmf,
    int xExt,
    int yExt,
    BOOL bTransferOwnership = FALSE);

Parametry

Hmf
Dojście do metapliku użytego do utworzenia CPictureHolder obiektu.

xExt
Zakres X obrazu.

yExt
Zakres Y obrazu.

Btransferownership
Wskazuje, czy obiekt obrazu przejmie własność obiektu metapliku.

Wartość zwracana

Nonzero, jeśli obiekt został pomyślnie utworzony; w przeciwnym razie 0.

Uwagi

Jeśli parametr bTransferOwnership ma wartość TRUE, obiekt wywołujący nie powinien używać obiektu metapliku w żaden sposób po powrocie tego wywołania. Jeśli parametr bTransferOwnership ma wartość FALSE, obiekt wywołujący jest odpowiedzialny za zapewnienie, że obiekt metapliku pozostaje ważny przez cały okres istnienia obiektu obrazu.

CPictureHolder::GetDisplayString

Pobiera ciąg wyświetlany w przeglądarce właściwości kontenera.

BOOL GetDisplayString(CString& strValue);

Parametry

strValue
Odwołanie do CString, który ma zawierać ciąg wyświetlania.

Wartość zwracana

Nonzero, jeśli ciąg został pomyślnie pobrany; w przeciwnym razie 0.

CPictureHolder::GetPictureDispatch

Ta funkcja zwraca wskaźnik do interfejsu CPictureHolderIPictureDisp obiektu.

LPPICTUREDISP GetPictureDispatch();

Wartość zwracana

Wskaźnik do interfejsu CPictureHolderIPictureDisp obiektu.

Uwagi

Obiekt wywołujący musi wywołać Release ten wskaźnik po zakończeniu z nim.

CPictureHolder::GetType

Wskazuje, czy obraz jest mapą bitową, metaplikiem, czy ikoną.

short GetType();

Wartość zwracana

Wartość wskazująca typ obrazu. Możliwe wartości i ich znaczenie są następujące:

Wartość	Znaczenie
PICTYPE_UNINITIALIZED	CPictureHolder obiekt jest unititializowany.
PICTYPE_NONE	CPictureHolder obiekt jest pusty.
PICTYPE_BITMAP	Obraz jest mapą bitową.
PICTYPE_METAFILE	Obraz jest metaplikiem.
PICTYPE_ICON	Obraz jest ikoną.

CPictureHolder::m_pPict

Wskaźnik do interfejsu CPictureHolderIPicture obiektu.

LPPICTURE m_pPict;

CPictureHolder::Render

Renderuje obraz w prostokątze, do których odwołuje się rcRender.

void Render(
    CDC* pDC,
    const CRect& rcRender,
    const CRect& rcWBounds);

Parametry

Pdc
Wskaźnik do kontekstu wyświetlania, w którym obraz ma być renderowany.

rcRender
Prostokąt, w którym obraz ma być renderowany.

rcWBounds
Prostokąt reprezentujący prostokąt ograniczenia obiektu renderujący obraz. W przypadku kontrolki ten prostokąt jest parametrem rcBounds przekazanym do przesłonięcia COleControl::OnDraw.

CPictureHolder::SetPictureDispatch

CPictureHolder Połączenie obiekt do interfejsuIPictureDisp.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Parametry

pDisp
Wskaźnik do nowego IPictureDisp interfejsu.

Zobacz też

Wykres hierarchii
Klasa CFontHolder