CPictureHolder Sınıfı
Kullanıcının denetiminizde bir resim görüntülemesine olanak tanıyan bir Picture özelliği uygular.
Sözdizimi
class CPictureHolder
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CPictureHolder::CPictureHolder | Bir CPictureHolder nesne oluşturur. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CPictureHolder::CreateEmpty | Boş CPictureHolder bir nesne oluşturur. |
| CPictureHolder::CreateFromBitmap | CPictureHolder Bit eşlemden bir nesne oluşturur. |
| CPictureHolder::CreateFromIcon | CPictureHolder Simgeden bir nesne oluşturur. |
| CPictureHolder::CreateFromMetafile | CPictureHolder Meta dosyadan bir nesne oluşturur. |
| CPictureHolder::GetDisplayString | Denetim kapsayıcısının özellik tarayıcısında görüntülenen dizeyi alır. |
| CPictureHolder::GetPictureDispatch | Nesnenin CPictureHolder IDispatch arabirimini döndürür. |
| CPictureHolder::GetType | Nesnenin CPictureHolder bit eşlem mi, meta dosyası mı yoksa simge mi olduğunu söyler. |
| CPictureHolder::Render | Resmi işler. |
| CPictureHolder::SetPictureDispatch | Nesnenin CPictureHolder arabirimini IDispatch ayarlar. |
Ortak Veri Üyeleri
| Veri Akışı Adı | Açıklama |
|---|---|
| CPictureHolder::m_pPict | Resim nesnesinin işaretçisi. |
Açıklamalar
CPictureHolder temel sınıfına sahip değildir.
Hisse senedi Picture özelliğiyle geliştirici, görüntü için bir bit eşlem, simge veya meta dosyası belirtebilir.
Özel resim özellikleri oluşturma hakkında bilgi için MFC ActiveX Denetimleri: ActiveX Denetiminde Resimleri Kullanma makalesine bakın.
Devralma Hiyerarşisi
CPictureHolder
Gereksinimler
Üst bilgi: afxctl.h
CPictureHolder::CPictureHolder
Bir CPictureHolder nesne oluşturur.
CPictureHolder();
CPictureHolder::CreateEmpty
Boş CPictureHolder bir nesne oluşturur ve bir arabirime IPicture bağlar.
BOOL CreateEmpty();
Dönüş Değeri
Nesne başarıyla oluşturulduysa sıfır olmayan; aksi takdirde 0.
CPictureHolder::CreateFromBitmap
içindeki resim nesnesini CPictureHolderbaşlatmak için bit eşlem kullanır.
BOOL CreateFromBitmap(
UINT idResource);
BOOL CreateFromBitmap(
CBitmap* pBitmap,
CPalette* pPal = NULL,
BOOL bTransferOwnership = TRUE);
BOOL CreateFromBitmap(
HBITMAP hbm,
HPALETTE hpal = NULL,
BOOL bTransferOwnership = FALSE);
Parametreler
idResource
Bit eşlem kaynağının kaynak kimliği.
pBitmap
CBitmap nesnesinin işaretçisi.
pPal
CPalette nesnesinin işaretçisi.
bTransferOwnership
Resim nesnesinin bit eşlem ve palet nesnelerinin sahipliğini alıp almayacağını gösterir.
Hbm
Nesnenin oluşturulduğu bit eşlem tutamacı CPictureHolder .
hpal
Bit eşlemi işlemek için kullanılan paletin tutamacı.
Dönüş Değeri
Nesne başarıyla oluşturulduysa sıfır olmayan; aksi takdirde 0.
Açıklamalar
bTransferOwnership TRUE ise, çağıranın bu çağrı döndürdüğünde bit eşlem veya palet nesnesini hiçbir şekilde kullanmaması gerekir. bTransferOwnership YANLIŞ ise, çağıran, bit eşlem ve palet nesnelerinin resim nesnesinin ömrü boyunca geçerli kalmasını sağlamakla sorumludur.
CPictureHolder::CreateFromIcon
içindeki resim nesnesini başlatmak için bir CPictureHoldersimge kullanır.
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
Parametreler
idResource
Bit eşlem kaynağının kaynak kimliği.
hIcon
Nesnenin oluşturulduğu simgenin CPictureHolder tutamacı.
bTransferOwnership
Resim nesnesinin simge nesnesinin sahipliğini alıp almayacağını gösterir.
Dönüş Değeri
Nesne başarıyla oluşturulduysa sıfır olmayan; aksi takdirde 0.
Açıklamalar
bTransferOwnership TRUE ise, çağıranın bu çağrı döndürdüğünde simge nesnesini hiçbir şekilde kullanmaması gerekir. bTransferOwnership YANLIŞ ise, çağıran, simge nesnesinin resim nesnesinin ömrü boyunca geçerli kalmasını sağlamakla sorumludur.
CPictureHolder::CreateFromMetafile
içindeki resim nesnesini başlatmak için meta CPictureHolderdosyası kullanır.
BOOL CreateFromMetafile(
HMETAFILE hmf,
int xExt,
int yExt,
BOOL bTransferOwnership = FALSE);
Parametreler
hmf
Nesneyi oluşturmak için kullanılan meta dosyası için tanıtıcı CPictureHolder .
xExt
Resmin X boyutu.
yExt
Resmin Y boyutu.
bTransferOwnership
Resim nesnesinin meta dosyası nesnesinin sahipliğini alıp almayacağını gösterir.
Dönüş Değeri
Nesne başarıyla oluşturulduysa sıfır olmayan; aksi takdirde 0.
Açıklamalar
bTransferOwnership TRUE ise, çağıran bu çağrı döndürdüğünde meta dosyası nesnesini hiçbir şekilde kullanmamalıdır. bTransferOwnership YANLIŞ ise, çağıran, meta dosyası nesnesinin resim nesnesinin ömrü boyunca geçerli kalmasını sağlamakla sorumludur.
CPictureHolder::GetDisplayString
Kapsayıcının özellik tarayıcısında görüntülenen dizeyi alır.
BOOL GetDisplayString(CString& strValue);
Parametreler
strValue
Görüntü dizesini tutan CString'e başvuru.
Dönüş Değeri
Dize başarıyla alınırsa sıfır olmayan; aksi takdirde 0.
CPictureHolder::GetPictureDispatch
Bu işlev nesnenin IPictureDisp arabirimine CPictureHolder bir işaretçi döndürür.
LPPICTUREDISP GetPictureDispatch();
Dönüş Değeri
Nesnenin arabirimine CPictureHolder bir IPictureDisp işaretçi.
Açıklamalar
Çağıranın, bitirdiğinde bu işaretçiyi çağırması Release gerekir.
CPictureHolder::GetType
Resmin bit eşlem mi, meta dosyası mı yoksa simge mi olduğunu gösterir.
short GetType();
Dönüş Değeri
Resmin türünü gösteren değer. Olası değerler ve anlamları aşağıdaki gibidir:
| Değer | Anlamı |
|---|---|
| PICTYPE_UNINITIALIZED | CPictureHolder nesnesi birleştirilir. |
| PICTYPE_NONE | CPictureHolder nesnesi boş. |
| PICTYPE_BITMAP | Resim bir bit eşlemdir. |
| PICTYPE_METAFILE | Resim bir meta dosyasıdır. |
| PICTYPE_ICON | Resim bir simgedir. |
CPictureHolder::m_pPict
Nesnenin arabirimine CPictureHolder bir IPicture işaretçi.
LPPICTURE m_pPict;
CPictureHolder::Render
Resmi rcRender tarafından başvuruda bulunan dikdörtgende işler.
void Render(
CDC* pDC,
const CRect& rcRender,
const CRect& rcWBounds);
Parametreler
pDC
Resmin işleneceği görüntü bağlamı işaretçisi.
rcRender
Resmin işlendiği dikdörtgen.
rcWBounds
Resmi işleme nesnesinin sınırlayıcı dikdörtgenini temsil eden dikdörtgen. Bir denetim için, bu dikdörtgen COleControl::OnDraw geçersiz kılmaya geçirilen rcBounds parametresidir.
CPictureHolder::SetPictureDispatch
CPictureHolder Nesneyi bir IPictureDisp arabirime bağlar.
void SetPictureDispatch(LPPICTUREDISP pDisp);
Parametreler
pDisp
Yeni IPictureDisp arabirim işaretçisi.