CJumpList Sınıfı

A CJumpList , görev çubuğundaki bir simgeye sağ tıkladığınızda görüntülenen kısayolların listesidir.

Sözdizimi

class CJumpList;

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CJumpList::CJumpList	Bir CJumpList nesne oluşturur.
CJumpList::~CJumpList	Bir CJumpList nesneyi yok eder.

Veri Akışı Adı	Açıklama
CJumpList::AbortList	İşleme olmadan liste oluşturma işlemini durdurur.
CJumpList::AddDestination	Aşırı yüklendi. Listeye hedef ekler.
CJumpList::AddKnownCategory	Listeye Bilinen Bir Kategori ekler.
CJumpList::AddTask	Aşırı yüklendi. Kurallı Görevler kategorisine öğe ekler.
CJumpList::AddTasks	Kurallı Görevler kategorisine öğe ekler.
CJumpList::AddTaskSeparator	Görevler arasına bir ayırıcı ekler.
CJumpList::ClearAll	Şu ana kadar geçerli örneğine CJumpList eklenmiş olan tüm görevleri ve hedefleri kaldırır.
CJumpList::ClearAllDestinations	Şu ana kadar geçerli örneğine CJumpList eklenmiş olan tüm hedefleri kaldırır.
CJumpList::CommitList	Liste oluşturma işlemini sonlandırır ve bildirilen listeyi ilişkili depoya (bu örnekte kayıt defteri) işler.
CJumpList::GetDestinationList	Hedef listeye bir arabirim işaretçisi alır.
CJumpList::GetMaxSlots	Çağıran uygulamanın hedef menüsünde görüntülenebilen kategori üst bilgileri de dahil olmak üzere en fazla öğe sayısını alır.
CJumpList::GetRemovedItems	Kaldırılan hedefleri temsil eden öğe dizisini döndürür.
CJumpList::InitializeList	Liste oluşturma işlemini başlatır.
CJumpList::SetAppID	Oluşturulacak listenin Uygulama Kullanıcı Modeli Kimliğini ayarlar.

Devralma Hiyerarşisi

CJumpList

Gereksinimler

Üst bilgi: afxadv.h

CJumpList::~CJumpList

Bir CJumpList nesneyi yok eder.

~CJumpList();

CJumpList::AbortList

İşleme olmadan liste oluşturma işlemini durdurur.

void AbortList();

Açıklamalar

Bu yöntemi çağırmak, çağrısı CommitListyapılmadan yok etmeyle CJumpList aynı etkiye sahiptir.

CJumpList::AddDestination

Listeye hedef ekler.

BOOL AddDestination(
    LPCTSTR lpcszCategoryName,
    LPCTSTR strDestinationPath);

BOOL AddDestination(
    LPCTSTR strCategoryName,
    IShellItem* pShellItem);

BOOL AddDestination(
    LPCTSTR strCategoryName,
    IShellLink* pShellLink);

Parametreler

lpcszCategoryName
Bir kategori adı belirtir. Belirtilen kategori yoksa oluşturulur.

strDestinationPath
Hedef dosyanın yolunu belirtir.

strCategoryName
Bir kategori adı belirtir. Belirtilen kategori yoksa oluşturulur.

pShellItem
Eklenen hedefi temsil eden bir Kabuk Öğesi belirtir.

pShellLink
Eklenen hedefi temsil eden bir Kabuk Bağlantısı belirtir.

Dönüş Değeri

Açıklamalar

örneği CJumpList , eklenen hedefleri dahili olarak biriktirir ve sonra içinde işler CommitList.

CJumpList::AddKnownCategory

Listeye Bilinen Bir Kategori ekler.

BOOL AddKnownCategory(KNOWNDESTCATEGORY category);

Parametreler

category
Bilinen bir kategori türünü belirtir. KDC_RECENT veya KDC_KNOWN olabilir.

Dönüş Değeri

Açıklamalar

Bilinen Kategoriler, kullanan SHAddToRecentDocs her uygulama için otomatik olarak hesapladığımız (veya bazı senaryolarda kabuk tarafından uygulama adına çağrılacağı için dolaylı olarak kullanacağımız) Sık Kullanılan ve Son kullanılan kategorilerdir.

CJumpList::AddTask

Kurallı Görevler kategorisine öğe ekler.

BOOL AddTask(
    LPCTSTR strTargetExecutablePath,
    LPCTSTR strCommandLineArgs,
    LPCTSTR strTitle,
    LPCTSTR strIconLocation,
    int iIconIndex);

BOOL AddTask(IShellLink* pShellLink);

Parametreler

strTargetExecutablePath
Hedef görev yolunu belirtir.

strCommandLineArgs
strTargetExecutablePath tarafından belirtilen yürütülebilir dosyanın komut satırı bağımsız değişkenlerini belirtir.

strTitle
Hedef Listesinde görüntülenecek görev adı.

strIconLocation
Hedef Liste'de başlıkla birlikte görüntülenecek simgenin konumu.

iIconIndex
Simge dizini.

pShellLink
Eklenecek görevi temsil eden Kabuk Bağlantısı.

Dönüş Değeri

Açıklamalar

örneği CJumpList , belirtilen görevleri biriktirir ve sırasında CommitListHedef Listesine ekler. Görev öğeleri, uygulamanın hedef menüsünün en altında bir kategoride görünür. Bu kategori, kullanıcı arabiriminde doldurulduğunda diğer tüm kategorilere göre önceliklidir.

CJumpList::AddTasks

Kurallı Görevler kategorisine öğe ekler.

BOOL AddTasks(IObjectArray* pObjectCollection);

Parametreler

pObjectCollection
Eklenecek görev koleksiyonu.

Dönüş Değeri

Açıklamalar

CJumpList örneği, belirtilen görevleri biriktirir ve bunları sırasında CommitListHedef Listesine ekler. Görev öğeleri, uygulamanın hedef menüsünün en altında bir kategoride görünür. Bu kategori, kullanıcı arabiriminde doldurulduğunda diğer tüm kategorilere göre önceliklidir.

CJumpList::AddTaskSeparator

Görevler arasına bir ayırıcı ekler.

BOOL AddTaskSeparator();

Dönüş Değeri

Başarılı olursa sıfır olmayan, değilse 0.

CJumpList::CJumpList

Bir CJumpList nesne oluşturur.

CJumpList(BOOL bAutoCommit = TRUE);

Parametreler

bAutoCommit
Bu parametre YANLIŞ ise liste, yıkıcıda otomatik olarak işlenmez.

CJumpList::ClearAll

Şu ana kadar geçerli örneğine CJumpList eklenmiş olan tüm görevleri ve hedefleri kaldırır.

void ClearAll();

Açıklamalar

Bu yöntem tüm verileri ve iç arabirimleri temizler ve serbest bırakır.

CJumpList::ClearAllDestinations

Şu ana kadar geçerli CJumpList örneğine eklenmiş olan tüm hedefleri kaldırır.

void ClearAllDestinations();

Açıklamalar

Hedef liste oluşturmanın geçerli oturumunda şimdiye kadar eklenmiş olan tüm hedefleri kaldırmanız ve diğer hedefleri yeniden eklemeniz gerekiyorsa bu işlevi çağırın. dahili ICustomDestinationList başlatıldıysa, canlı bırakılır.

CJumpList::CommitList

Liste oluşturma işlemini sonlandırır ve bildirilen listeyi ilişkili depoya (bu örnekte kayıt defteri) işler.

BOOL CommitList();

Dönüş Değeri

Açıklamalar

İşleme atomiktir. İşleme başarısız olursa bir hata döndürülür. Çağrıldığında CommitList , kaldırılan öğelerin geçerli listesi temizlenir. Bu yöntemin çağrılması, etkin bir liste oluşturma işlemine sahip olmaması için nesneyi sıfırlar. Listeyi BeginList güncelleştirmek için yeniden çağrılmaları gerekir.

CJumpList::GetDestinationList

Hedef listeye bir arabirim işaretçisi alır.

ICustomDestinationList* GetDestinationList();

Dönüş Değeri

Açıklamalar

Atlama listesi başlatılmadıysa veya işlendiyse veya durdurulduysa, döndürülen değer NULL olur.

CJumpList::GetMaxSlots

Çağıran uygulamanın hedef menüsünde görüntülenebilen kategori üst bilgileri de dahil olmak üzere en fazla öğe sayısını alır.

UINT GetMaxSlots() const;

Dönüş Değeri

Açıklamalar

Uygulamalar yalnızca bu değere kadar birleştirilmiş birkaç öğeyi ve kategori üst bilgisini bildirebilir. , AppendKnownCategoryveya AddUserTasks çağrısı AppendCategorybu numarayı aşarsa hata döndürür.

CJumpList::GetRemovedItems

Kaldırılan hedefleri temsil eden öğe dizisini döndürür.

IObjectArray* GetRemovedItems();

Dönüş Değeri

Açıklamalar

Atlama listesinin başlatılması sırasında kaldırılan hedefler alınır. Yeni bir hedef liste oluştururken, uygulamaların önce kaldırılan hedef listesini işlemesi ve kaldırılan liste numaralandırıcısı tarafından döndürülen öğeler için izleme verilerini temizlemesi beklenir. Bir uygulama, geçerli çağrının BeginList başlatıldığı işlemde yeni kaldırılmış bir öğe sağlamaya çalışırsa, uygulamaların kaldırılan listeye uygun olduğundan emin olmak için bu öğeyi yeniden ekleyen yöntem çağrısı başarısız olur.

CJumpList::InitializeList

Liste oluşturma işlemini başlatır.

BOOL InitializeList();

Dönüş Değeri

Açıklamalar

kullanarak bir işaretçi ICustomDestinationList almak, kullanan GetDestinationListkullanılabilir yuva GetMaxSlotssayısı veya kullanan GetRemovedItemskaldırılan öğelerin listesi dışında bu yöntemi açıkça çağırmanız gerekmez.

CJumpList::SetAppID

Oluşturulacak listenin Uygulama Kullanıcı Modeli Kimliğini ayarlar.

void SetAppID(LPCTSTR strAppID);

Parametreler

strAppID
Uygulama Kullanıcı Modeli Kimliğini belirten bir dize.

Ayrıca bkz.

Sınıflar