Klasa CPictureHolder
Implementuje właściwość Obraz, która umożliwia użytkownikowi wyświetlanie obrazu w kontrolce.
Składnia
class CPictureHolder
Elementy członkowskie
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 CPictureHolder IPictureDisp obiektu.
LPPICTUREDISP GetPictureDispatch();
Wartość zwracana
Wskaźnik do interfejsu CPictureHolder IPictureDisp 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 CPictureHolder IPicture 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 Łączy obiekt z interfejsemIPictureDisp.
void SetPictureDispatch(LPPICTUREDISP pDisp);
Parametry
pDisp
Wskaźnik do nowego IPictureDisp interfejsu.