CMFCShellListCtrl Sınıfı
sınıfı, CMFCShellListCtrl Windows liste denetimi işlevselliği sağlar ve kabuk öğelerinin listesini görüntüleme özelliğini ekleyerek bunu genişletir.
Sözdizimi
class CMFCShellListCtrl : public CMFCListCtrl
Üyeler
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CMFCShellListCtrl::D isplayFolder | Sağlanan bir klasörde bulunan öğelerin listesini görüntüler. |
| CMFCShellListCtrl::D isplayParentFolder | Şu anda görüntülenen klasörün üst öğesi olan klasörde bulunan öğelerin listesini görüntüler. |
| CMFCShellListCtrl::EnableShellContextMenu | Kısayol menüsünü etkinleştirir veya devre dışı bırakır. |
| CMFCShellListCtrl::GetCurrentFolder | Geçerli klasörün yolunu alır. |
| CMFCShellListCtrl::GetCurrentFolderName | Geçerli klasörün adını alır. |
| CMFCShellListCtrl::GetCurrentItemIdList | Geçerli liste denetim öğesinin PIDL değerini döndürür. |
| CMFCShellListCtrl::GetCurrentShellFolder | Geçerli Shell klasörüne bir işaretçi döndürür. |
| CMFCShellListCtrl::GetItemPath | Bir öğenin metin yolunu döndürür. |
| CMFCShellListCtrl::GetItemTypes | Liste denetimi tarafından görüntülenen Kabuk öğesi türlerini döndürür. |
| CMFCShellListCtrl::IsDesktop | Seçili durumdaki klasörün masaüstü klasörü olup olmadığını denetler. |
| CMFCShellListCtrl::OnCompareItems | Çerçeve, iki öğeyi karşılaştırdığında bu yöntemi çağırır. (Geçersiz Kılmalar CMFCListCtrl::OnCompareItems.) |
| CMFCShellListCtrl::OnFormatFileDate | Çerçeve, liste denetimi tarafından görüntülenen dosya tarihini aldığında çağrılır. |
| CMFCShellListCtrl::OnFormatFileSize | Çerçeve bir liste denetiminin dosya boyutunu dönüştürdüğünde çağrılır. |
| CMFCShellListCtrl::OnGetItemIcon | Çerçeve bir liste denetim öğesinin simgesini aldığında çağrılır. |
| CMFCShellListCtrl::OnGetItemText | Çerçeve bir liste denetim öğesinin metnini dönüştürdüğünde çağrılır. |
| CMFCShellListCtrl::OnSetColumns | Sütunların adlarını ayarlarken çerçeve tarafından çağrılır. |
| CMFCShellListCtrl::Refresh | Liste denetimini yeniler ve yeniden boyar. |
| CMFCShellListCtrl::SetItemTypes | Liste denetimi tarafından görüntülenen öğelerin türünü ayarlar. |
Açıklamalar
sınıfı, CMFCShellListCtrl programınızın Windows kabuk öğelerini listelemesini sağlayarak CMFCListCtrl Sınıfının işlevselliğini genişletir. Kullanılan görüntüleme biçimi, Gezgin penceresi için liste görünümüne benzer.
Tam bir Gezgin penceresi oluşturmak için bir CMFCShellTreeCtrl nesnesi bir CMFCShellListCtrl nesneyle ilişkilendirilebilir. Ardından öğesinde CMFCShellTreeCtrl bir öğe seçildiğinde, nesnenin CMFCShellListCtrl seçili öğenin içeriğini listelemesine neden olur.
Örnek
Aşağıdaki örnekte, sınıfının bir nesnesinin CMFCShellListCtrl nasıl oluşturulacağı ve o anda görüntülenen klasörün üst klasörünün nasıl görüntüleneceği gösterilmektedir. Bu kod parçacığı Explorer örneğinin bir parçasıdır.
CMFCShellListCtrl m_wndList;
CRect rectDummy(0, 0, 0, 0);
// The this pointer points to CExplorerView class which extends the CView class.
m_wndList.Create(WS_CHILD | WS_VISIBLE | LVS_REPORT, rectDummy, this, 1);
m_wndList.DisplayParentFolder();
Devralma Hiyerarşisi
CMFCShellListCtrl
Gereksinimler
Üst bilgi: afxshelllistCtrl.h
CMFCShellListCtrl::D isplayFolder
Sağlanan klasörde bulunan öğelerin listesini görüntüler.
virtual HRESULT DisplayFolder(LPCTSTR lpszPath);
virtual HRESULT DisplayFolder(LPAFX_SHELLITEMINFO lpItemInfo);
Parametreler
lpszPath
[in] Bir klasörün yolunu içeren dize.
lpItemInfo
[in] Görüntülenecek klasörü açıklayan bir LPAFX_SHELLITEMINFO yapı işaretçisi.
Dönüş Değeri
Başarılı olursa S_OK; E_FAIL.
CMFCShellListCtrl::D isplayParentFolder
ŞU anda görüntülenen klasörün üst klasörünü görüntülemek için CMFCShellListCtrl nesnesini güncelleştirir.
virtual HRESULT DisplayParentFolder();
Dönüş Değeri
Başarılı olursa S_OK; E_FAIL.
CMFCShellListCtrl::EnableShellContextMenu
Kısayol menüsünü etkinleştirir.
void EnableShellContextMenu(BOOL bEnable = TRUE);
Parametreler
bEnable
[in] Çerçevenin kısayol menüsünü etkinleştirip etkinleştirmediğini belirten boole değeri.
CMFCShellListCtrl::GetCurrentFolder
CMFCShellListCtrl nesnesinde seçili durumdaki klasörün yolunu alır.
BOOL GetCurrentFolder(CString& strPath) const;
Parametreler
strPath
[out] yönteminin yolu yazdığı bir dize parametresi başvurusu.
Dönüş Değeri
Başarılı olursa sıfır olmayan; 0 aksi takdirde.
Açıklamalar
içinde CMFCShellListCtrlseçili klasör yoksa bu yöntem başarısız olur.
CMFCShellListCtrl::GetCurrentFolderName
CMFCShellListCtrl nesnesinde seçili durumdaki klasörün adını alır.
BOOL GetCurrentFolderName(CString& strName) const;
Parametreler
strName
[out] Yönteminin adı yazdığı bir dize parametresine başvuru.
Dönüş Değeri
Başarılı olursa sıfır olmayan; 0 aksi takdirde.
Açıklamalar
içinde CMFCShellListCtrlseçili klasör yoksa bu yöntem başarısız olur.
CMFCShellListCtrl::GetCurrentItemIdList
Seçili durumdaki öğenin PIDL değerini döndürür.
LPITEMIDLIST GetCurrentItemIdList() const;
Dönüş Değeri
Geçerli öğenin PIDL'i.
CMFCShellListCtrl::GetCurrentShellFolder
CMFCShellListCtrl nesnesinde seçili durumdaki öğeye bir işaretçi alır.
const IShellFolder* GetCurrentShellFolder() const;
Dönüş Değeri
Seçili nesne için IShellFolder Arabirimi işaretçisi.
Açıklamalar
Şu anda seçili nesne yoksa bu yöntem NULL döndürür.
CMFCShellListCtrl::GetItemPath
Bir öğenin yolunu alır.
BOOL GetItemPath(
CString& strPath,
int iItem) const;
Parametreler
strPath
[out] Yolu alan bir dizeye başvuru.
iItem
[in] Liste öğesinin dizini.
Dönüş Değeri
Başarılı olursa DOĞRU; FALSE aksi takdirde.
Açıklamalar
iItem tarafından sağlanan dizin, CMFCShellListCtrl Sınıfı nesnesi tarafından şu anda görüntülenen öğeleri temel alır.
CMFCShellListCtrl::GetItemTypes
CMFCShellListCtrl nesnesi tarafından görüntülenen öğe türünü döndürür.
SHCONTF GetItemTypes() const;
Dönüş Değeri
içinde CMFCShellListCtrllistelenen öğelerin türünü içeren bir SHCONTF değeri.
Açıklamalar
içinde CMFCShellListCtrllistelenen öğelerin türünü ayarlamak için CMFCShellListCtrl::SetItemTypes'ı çağırın.
CMFCShellListCtrl::IsDesktop
CMFCShellListCtrl nesnesinde görüntülenen klasörün masaüstü klasörü olup olmadığını belirler.
BOOL IsDesktop() const;
Dönüş Değeri
Görüntülenen klasör masaüstü klasörüyse TRUE; FALSE aksi takdirde.
CMFCShellListCtrl::OnCompareItems
Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.
virtual int OnCompareItems(
LPARAM lParam1,
LPARAM lParam2,
int iColumn);
Parametreler
[in] lParam1
[in] lParam2
[in] iColumn
Dönüş Değeri
Açıklamalar
CMFCShellListCtrl::OnFormatFileDate
Bir nesneyle ilişkili tarihi dizeye dönüştürmesi gerektiğinde çerçeve bu yöntemi çağırır.
virtual void OnFormatFileDate(
const CTime& tmFile,
CString& str);
Parametreler
tmFile
[in] Bir dosyayla ilişkilendirilmiş tarih.
str
[out] Biçimlendirilmiş dosya tarihini içeren bir dize.
Açıklamalar
CMFCShellListCtrl Sınıfı nesnesi bir dosyayla ilişkili tarihi görüntülediğinde, bu tarihi dize biçimine dönüştürmesi gerekir. bu CMFCShellListCtrl dönüştürmeyi yapmak için bu yöntemi kullanır. Varsayılan olarak, bu yöntem tarihi bir dize olarak biçimlendirmek için geçerli yerel ayarı kullanır.
CMFCShellListCtrl::OnFormatFileSize
Çerçeve, bir nesnenin boyutunu dizeye dönüştürdüğünde bu yöntemi çağırır.
virtual void OnFormatFileSize(
long lFileSize,
CString& str);
Parametreler
lFileSize
[in] Çerçevenin görüntüleneceği dosyanın boyutu.
str
[out] Biçimlendirilmiş dosya boyutunu içeren bir dize.
Açıklamalar
CMFCShellListCtrl Sınıfı nesnesinin dosyanın boyutunu görüntülemesi gerektiğinde, dosya boyutunu dize biçimine dönüştürmesi gerekir. bu CMFCShellListCtrl dönüştürmeyi yapmak için bu yöntemi kullanır. Varsayılan olarak, bu yöntem dosya boyutunu bayttan kilobayta dönüştürür ve sonra boyutu dizeye biçimlendirmek için geçerli yerel ayarı kullanır.
CMFCShellListCtrl::OnGetItemIcon
Çerçeve, kabuk listesi öğesiyle ilişkili simgeyi almak için bu yöntemi çağırır.
virtual int OnGetItemIcon(
int iItem,
LPAFX_SHELLITEMINFO pItem);
Parametreler
iItem
[in] Öğe dizini.
pItem
[in] Öğeyi açıklayan bir LPAFX_SHELLITEMINFO parametresi.
Dönüş Değeri
Başarılı olursa simge görüntüsünün dizini; İşlev başarısız olursa -1.
Açıklamalar
Simge görüntüsü dizini, sistem görüntüsü listesini temel alır.
Varsayılan olarak, bu yöntem pItem parametresini kullanır. iItem değeri varsayılan uygulamada kullanılmaz. Özel davranış uygulamak için iItem kullanabilirsiniz.
CMFCShellListCtrl::OnGetItemText
Çerçeve, bir kabuk öğesinin metnini alması gerektiğinde bu yöntemi çağırır.
virtual CString OnGetItemText(
int iItem,
int iColumn,
LPAFX_SHELLITEMINFO pItem);
Parametreler
iItem
[in] Öğe dizini.
iColumn
[in] İlgi alanı sütunu.
pItem
[in] Öğeyi açıklayan bir LPAFX_SHELLITEMINFO parametresi.
Dönüş Değeri
CString Öğeyle ilişkili metni içeren bir.
Açıklamalar
Nesnedeki CMFCShellListCtrl her öğenin bir veya daha fazla sütunda metni olabilir. Çerçeve bu yöntemi çağırdığında ilgilendiği sütunu belirtir. Bu işlevi el ile çağırırsanız, ilgilendiğiniz sütunu da belirtmeniz gerekir.
Varsayılan olarak, bu yöntem hangi öğenin işleneceğini belirlemek için pItem parametresini kullanır. iItem değeri varsayılan uygulamada kullanılmaz.
CMFCShellListCtrl::OnSetColumns
Çerçeve, sütunların adlarını ayarlarken bu yöntemi çağırır.
virtual void OnSetColumns();
Açıklamalar
Varsayılan olarak, çerçeve bir CMFCShellListCtrl nesnede dört sütun oluşturur. Bu sütunların adları Ad, Boyut, Tür ve Değiştirildi'dir. Sütun sayısını ve adlarını özelleştirmek için bu yöntemi geçersiz kılabilirsiniz.
CMFCShellListCtrl::Refresh
CMFCShellListCtrl nesnesini yeniler ve yeniden boyar.
virtual HRESULT Refresh();
Dönüş Değeri
S_OK başarılı olursa; aksi takdirde bir hata değeri.
Açıklamalar
Nesnesi tarafından görüntülenen öğe listesini yenilemek için bu yöntemi çağırın CMFCShellListCtrl .
CMFCShellListCtrl::SetItemTypes
CMFCShellListCtrl nesnesinde listelenen öğelerin türünü ayarlar.
void SetItemTypes(SHCONTF nTypes);
Parametreler
nTypes
[in] Nesnenin desteklediği öğe türlerinin CMFCShellListCtrl listesi.
Açıklamalar
Öğe türleri listesi hakkında daha fazla bilgi için bkz . SHCONTF.
Ayrıca bkz.
Hiyerarşi Grafiği
Sınıflar
CMFCListCtrl Sınıfı
CMFCShellTreeCtrl Sınıfı