CMFCPopupMenu Sınıfı

Makale
08/04/2024

Windows açılır menü işlevselliğini uygular ve ayrık menüler ve araç ipuçları gibi özellikler ekleyerek genişletir. Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

Sözdizimi

class CMFCPopupMenu : public CMiniFrameWnd

Üyeler

Korumalı Oluşturucular

Veri Akışı Adı	Açıklama
CMFCPopupMenu::CMFCPopupMenu	Bir `CMFCPopupMenu` nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCPopupMenu::ActivatePopupMenu
CMFCPopupMenu::AlwaysShowEmptyToolsEntry	Kullanıcı tanımlı araçlar için boş girdileri göstermek üzere bir açılır menünün etkinleştirilip etkinleştirilmediğini ayarlar.
CMFCPopupMenu::AreAllCommandsShown
CMFCPopupMenu::CheckArea	Bir noktanın açılır menüye göre konumunu belirler.
CMFCPopupMenu::CloseMenu
CMFCPopupMenu::Create	Bir açılır menü oluşturur ve bunu nesneye `CMFCPopupMenu` ekler.
CMFCPopupMenu::D efaultMouseClickOnClose
CMFCPopupMenu::EnableMenuLogo	Açılır menü için logoyu başlatır.
CMFCPopupMenu::EnableMenuSound	Menü sesini etkinleştirir.
CMFCPopupMenu::EnableResize
CMFCPopupMenu::EnableScrolling
CMFCPopupMenu::EnableVertResize
CMFCPopupMenu::FindSubItemByCommand
CMFCPopupMenu::GetActiveMenu	Etkin olan menüyü döndürür.
CMFCPopupMenu::GetAnimationSpeed	Açılır menüler için animasyon hızını döndürür.
CMFCPopupMenu::GetAnimationType	Geçerli açılır menü animasyonu türünü döndürür.
CMFCPopupMenu::GetDropDirection
CMFCPopupMenu::GetForceMenuFocus	Bir açılır menü görüntülendiğinde odağın menü çubuğuna döndürülip döndürülmeyeceğini gösterir.
CMFCPopupMenu::GetForceShadow
CMFCPopupMenu::GetHMenu	Ekli menü kaynağına bir tanıtıcı döndürür.
CMFCPopupMenu::GetMenuBar	Açılır menünün içine eklenmiş CMFCPopupMenuBar değerini döndürür.
CMFCPopupMenu::GetMenuItem	Belirtilen dizindeki menü öğesine bir işaretçi döndürür.
CMFCPopupMenu::GetMenuItemCount	Açılan menüdeki öğelerin sayısını döndürür.
CMFCPopupMenu::GetMessageWnd	Çerçevenin açılır menü iletilerini yönlendirdiği pencereye bir işaretçi döndürür.
CMFCPopupMenu::GetParentArea
CMFCPopupMenu::GetParentButton	Üst araç çubuğu düğmesinin işaretçisini döndürür.
CMFCPopupMenu::GetParentPopupMenu	Üst açılır menüye yönelik bir işaretçi döndürür.
CMFCPopupMenu::GetParentRibbonElement
CMFCPopupMenu::GetParentToolBar	Üst araç çubuğuna bir işaretçi döndürür.
CMFCPopupMenu::GetQuickCustomizeType
CMFCPopupMenu::GetSelItem	Seçili durumdaki menü komutunun işaretçisini döndürür.
CMFCPopupMenu::HasBeenResized
CMFCPopupMenu::HideRarelyUsedCommands	Açılır menünün nadiren kullanılan komutları gizleyip gizleyemeyeceğini gösterir.
CMFCPopupMenu::InCommand
CMFCPopupMenu::InsertItem	Belirtilen konumdaki açılır menüye yeni bir öğe ekler.
CMFCPopupMenu::InsertSeparator	Belirtilen konumdaki açılır menüye bir ayırıcı ekler.
CMFCPopupMenu::IsAlwaysClose
CMFCPopupMenu::IsAlwaysShowEmptyToolsEntry
CMFCPopupMenu::IsCustomizePane	Açılır menünün QuickCustomizePane olarak çalışıp çalışmadığını gösterir.
CMFCPopupMenu::IsEscClose
CMFCPopupMenu::IsIdle	Bir açılır menünün şu anda boşta olup olmadığını gösterir.
CMFCPopupMenu::IsMenuSound
CMFCPopupMenu::IsQuickCustomize	İlişkili CMFCToolBarMenuButton Sınıfının QuickCustomize modunda olup olmadığını belirler.
CMFCPopupMenu::IsResizeble
CMFCPopupMenu::IsRightAlign	Menünün sağa mı yoksa sola mı hizalı olduğunu gösterir.
CMFCPopupMenu::IsScrollable
CMFCPopupMenu::IsSendMenuSelectMsg	Kullanıcı açılır menüden bir komut seçtiğinde çerçevenin üst çerçeveyi bilgilendirip uyarmadığını gösterir.
CMFCPopupMenu::IsShown	Açılır menünün şu anda görünür olup olmadığını gösterir.
CMFCPopupMenu::MoveTo
CMFCPopupMenu::OnCmdMsg	(Geçersiz Kılmalar `CFrameWnd::OnCmdMsg`.)
CMFCPopupMenu::P ostCommand
CMFCPopupMenu::P reTranslateMessage	(Geçersiz Kılmalar `CFrameWnd::PreTranslateMessage`.)
CMFCPopupMenu::RecalcLayout	Standart denetim çubukları açık veya kapalı olduğunda veya çerçeve penceresi yeniden boyutlandırıldığında çerçeve tarafından çağrılır. (Geçersiz Kılmalar CFrameWnd::RecalcLayout.)
CMFCPopupMenu::RemoveAllItems	Açılır menüden tüm öğeleri temizler.
CMFCPopupMenu::RemoveItem	Belirtilen öğeyi bir açılır menüden kaldırır.
CMFCPopupMenu::SaveState
CMFCPopupMenu::SetAnimationSpeed	Açılır menüler için animasyon hızını ayarlar.
CMFCPopupMenu::SetAnimationType	Açılır menü için animasyon türünü ayarlar.
CMFCPopupMenu::SetAutoDestroy
CMFCPopupMenu::SetDefaultItem	Açılır menü için varsayılan komutu ayarlar.
CMFCPopupMenu::SetForceMenuFocus	Açılır menü görüntülendiğinde giriş odağını menü çubuğuna dönmeye zorlar.
CMFCPopupMenu::SetForceShadow	Açılır menüler ana çerçevenin dışında göründüğünde çerçeveyi menü gölgeleri çizmeye zorlar.
CMFCPopupMenu::SetMaxWidth	Açılır menü için en yüksek genişliği ayarlayın.
CMFCPopupMenu::SetMessageWnd
CMFCPopupMenu::SetParentRibbonElement
CMFCPopupMenu::SetQuickCustomizeType
CMFCPopupMenu::SetQuickMode
CMFCPopupMenu::SetRightAlign	Açılır menüler için menü hizalamasını ayarlar.
CMFCPopupMenu::SetSendMenuSelectMsg	Kullanıcı bir komut seçtiğinde açılır menünün üst çerçevesini bilgilendirip bilgilendirmeyeceğini denetleyen bir bayrak ayarlar.
CMFCPopupMenu::ShowAllCommands	Açılır menüyü tüm komutları görüntülemeye zorlar.
CMFCPopupMenu::TriggerResize
CMFCPopupMenu::UpdateAllShadows	Tüm açılan menülerin gölgelerini güncelleştirir.
CMFCPopupMenu::UpdateShadow	Açılır menünün gölgesini güncelleştirir.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CMFCPopupMenu::CreateTearOffBar
CMFCPopupMenu::OnChangeHot
CMFCPopupMenu::OnChooseItem

Açıklamalar

Normalde MFC açılır menüleri otomatik olarak oluşturur. Nesneyi el ile oluşturmak istiyorsanız, yığında bir CMFCPopupMenu tane ayırın ve CMFCPopupMenu::Create öğesini çağırın.

Örnek

Aşağıdaki örnekte açılır menü nesnesinin nasıl yapılandırılır gösterilmektedir. Örnek, açılır menünün logosunu ve sesini ayarlamayı, animasyon hızını ve türünü ayarlamayı, açılır menü ana çerçevenin dışında göründüğünde menü gölgeleri çizmeyi, maksimum genişliği ayarlamayı ve açılır menünün sağ menü hizalamasını ayarlamayı gösterir. Bu kod parçacığı Özel Sayfalar örneğinin bir parçasıdır.

// 30 is the size of the logo in pixels.
pPopupMenu->EnableMenuLogo(30);
pPopupMenu->EnableMenuSound();
// 500 is the animation speed in milliseconds.
pPopupMenu->SetAnimationSpeed(500);
pPopupMenu->SetAnimationType(CMFCPopupMenu::SLIDE);
pPopupMenu->SetForceShadow(true);
// 200 is the maximum width of the pop-up menu in pixels.
pPopupMenu->SetMaxWidth(200);
pPopupMenu->SetRightAlign();
pPopupMenu->InsertSeparator();

Devralma Hiyerarşisi

CMFCPopupMenu

Gereksinimler

Üst bilgi: afxpopupmenu.h

CMFCPopupMenu::ActivatePopupMenu

static BOOL __stdcall ActivatePopupMenu(
    CFrameWnd* pTopFrame,
    CMFCPopupMenu* pPopupMenu);

Parametreler

[in] pTopFrame
[in] pPopupMenu

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::AlwaysShowEmptyToolsEntry

Kullanıcı tanımlı araçlar için boş girdileri göstermek üzere bir açılır menünün etkinleştirilip etkinleştirilmediğini ayarlar.

static void AlwaysShowEmptyToolsEntry(BOOL bShow = TRUE);

Parametreler

bShow
[in] Açılır menüde boş girdiler görüntülenebiliyorsa TRUE; FALSE aksi takdirde.

CMFCPopupMenu::AreAllCommandsShown

BOOL AreAllCommandsShown() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::CheckArea

Bir noktanın açılır menüye göre konumunu belirler.

MENUAREA_TYPE CheckArea(const CPoint& ptScreen) const;

Parametreler

ptScreen
[in] Ekran koordinatlarında bir nokta.

Dönüş Değeri

Noktanın açılır menüye göre nerede olduğunu gösteren bir MENUAREA_TYPE parametresi.

Açıklamalar

MENUAREA_TYPE parametresi aşağıdaki değerlerden herhangi birine sahip olabilir.

OUTSIDE - ptScreen açılır menünün dışındadır.
LOGO - ptScreen bir logo alanının üzerindedir.
TEAROFF_CAPTION - ptScreen , yırtılma açıklamalı alt yazının üzerindedir.
SHADOW_BOTTOM - ptScreen açılır menünün alt gölgesinin üzerindedir.
SHADOW_RIGHT - ptScreen açılır menünün sağ gölgesinin üzerindedir.
MENU - ptScreen komutun üzerindedir.

CMFCPopupMenu::CloseMenu

void CloseMenu(BOOL bSetFocusToBar = FALSE);

Parametreler

[in] bSetFocusToBar

Açıklamalar

CMFCPopupMenu::CMFCPopupMenu

CMFCPopupMenu nesnesi oluşturur.

CMFCPopupMenu(
    CMFCToolBarsMenuPropertyPage* pCustPage,
    LPCTSTR lpszTitle);

Parametreler

pCustPage
[in] Özelleştirme sayfasının işaretçisi.

lpszTitle
[in] Menü resim yazısını içeren bir dize.

Açıklamalar

Bu yöntem için CMFCPopupMenukaynakları ayırır. Açılır menü öğesini oluşturmak için CMFCPopupMenu::Create öğesini çağırın.

CMFCPopupMenu::Create

Bir açılır menü oluşturur ve bunu bir CMFCPopupMenu nesnesine ekler.

virtual BOOL Create(
    CWnd* pWndParent,
    int x,
    int y,
    HMENU hMenu,
    BOOL bLocked = FALSE,
    BOOL bOwnMessage = FALSE);

Parametreler

pWndParent
[in] için CMFCPopupMenuüst pencere.

x
[in] Açılır menünün konumunun yatay ekran koordinatı

y
[in] Açılır menünün konumunun dikey ekran koordinatı.

hMenu
[in] Menü kaynağının tanıtıcısı.

Engellenmiş
[in] Menünün özelleştirilebilir olup olmadığını gösteren boole parametresi. YANLIŞ, açılır menünün özelleştirilebilir olduğunu gösterir.

bOwnMessage
[in] Çerçevenin menü iletilerini nasıl yönlendirdiğini gösteren boole parametresi. Daha fazla ayrıntı için Açıklamalar bölümüne bakın.

Dönüş Değeri

Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

bOwnMessage TRUE ise, çerçeve tüm menü iletilerini pWndParent'e yönlendirir. bOwnMessage TRUE ise pWndParent NULL olmamalıdır. bOwnMessage YANLIŞ ise, çerçeve menü iletilerini üst açılır menüye yönlendirir.

Örnek

Aşağıdaki örnekte sınıfının yönteminin Create nasıl kullanılacağı gösterilmektedir CMFCPopuMenu . Bu kod parçacığı Özel Sayfalar örneğinin bir parçasıdır.

CMFCPopupMenu *pPopupMenu = new CMFCPopupMenu;
// CPoint point
// CMenu* pPopup
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
pPopupMenu->Create(this, point.x, point.y, pPopup->Detach());

CMFCPopupMenu::CreateTearOffBar

virtual CPane* CreateTearOffBar(
    CFrameWnd* pWndMain,
    UINT uiID,
    LPCTSTR lpszName);

Parametreler

[in] pWndMain
[in] uiID
[in] lpszName

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::D efaultMouseClickOnClose

virtual BOOL DefaultMouseClickOnClose() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::EnableMenuLogo

Açılır menü için logoyu başlatır.

void EnableMenuLogo(
    int iLogoSize,
    LOGO_LOCATION nLogoLocation = MENU_LOGO_LEFT);

Parametreler

iLogoSize
[in] Logonun piksel cinsinden boyutu.

nLogoLocation
[in] Logonun konumunu gösteren numaralandırılmış veri türü.

Açıklamalar

Logoyu görüntülemek için ana çerçeve penceresinde CFrameWndEx::OnDrawMenuLogo yöntemini uygulayın.

nLogoLocation için olası değerler MENU_LOGO_LEFT, MENU_LOGO_RIGHT, MENU_LOGO_TOP ve MENU_LOGO_BOTTOM'dır.

CMFCPopupMenu::EnableMenuSound

Menü sesini etkinleştirir.

static void EnableMenuSound(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] Sesi etkinleştirmek için TRUE, aksi takdirde YANLIŞ.

Açıklamalar

Sesi etkinleştirirseniz, bir kullanıcı açılır menüyü açtığında veya bir menü komutu seçtiğinde çerçeve PlaySound yöntemini çağırır. Bu özellik varsayılan olarak etkindir.

CMFCPopupMenu::EnableResize

void EnableResize(CSize sizeMinResize);

Parametreler

[in] sizeMinResize

Açıklamalar

CMFCPopupMenu::EnableScrolling

void EnableScrolling(BOOL = TRUE);

Parametreler

[in] BOOL

Açıklamalar

CMFCPopupMenu::EnableVertResize

void EnableVertResize(int nMinResize);

Parametreler

[in] nMinResize

Açıklamalar

CMFCPopupMenu::FindSubItemByCommand

CMFCToolBarMenuButton* FindSubItemByCommand(UINT uiCmd) const;

Parametreler

[in] uiCmd

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetActiveMenu

Etkin olan menüyü döndürür.

static CMFCPopupMenu* GetActiveMenu();

Dönüş Değeri

Etkin açılır menünün işaretçisi veya etkin bir açılır menü yoksa NULL.

Açıklamalar

Her uygulamanın en fazla bir etkin açılır menüsü olabilir.

CMFCPopupMenu::GetAnimationSpeed

Açılır menüler için animasyon hızını döndürür.

static UINT GetAnimationSpeed();

Dönüş Değeri

Açılan menü animasyonunun bitmek için gereken süreyi milisaniye cinsinden gösteren tamsayı.

Açıklamalar

Animasyon hızı genel bir değerdir. Açılır menülerin animasyon hızını değiştirmek için CMFCPopupMenu::SetAnimationSpeed kullanın.

CMFCPopupMenu::GetAnimationType

Geçerli açılır animasyon türünü döndürür.

static CMFCPopupMenu::ANIMATION_TYPE GetAnimationType(BOOL bNoSystem = FALSE);

Parametreler

bNoSystem
[in] Bu yöntemin genel değeri denetlediğini gösteren boole parametresi. Bu yöntemin CMFCPopupMenu Sınıfının bu örneği için animasyon stilini döndürmesini istiyorsanız YANLIŞ.

Dönüş Değeri

Animasyon türünü açıklayan numaralandırılmış değer.

Açıklamalar

Açılır menüler için animasyon stili, uygulamanız için geneldir. Animasyon stilini ayarlamak için CMFCPopupMenu::SetAnimationType kullanın.

Aşağıdaki tabloda olası animasyon türleri listelenmiştir.

Value	Açıklama
NO_ANIMATION	Açılır menü animasyonlu değildir ve hemen görünür.
AÇILMAK	Çerçeve, sol üst köşeden sağ alt köşeye açılan menüyü gösterir.
KAYDIRAK	Açılır menü yukarıdan aşağıya doğru hareket eder.
SOLMAK	Açılır menü ilk olarak saydam görünür ve yavaş yavaş katılaştırır.

CMFCPopupMenu::GetDropDirection

DROP_DIRECTION GetDropDirection() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetForceMenuFocus

Bir açılır menü görüntülendiğinde odağın menü çubuğuna döndürülip döndürülmeyeceğini gösterir.

static BOOL GetForceMenuFocus();

Dönüş Değeri

Bir açılır menü görüntülendiğinde giriş odağı menü çubuğuna döndürülürse TRUE; Açılan menü odağı koruyorsa YANLIŞ.

Açıklamalar

Varsayılan olarak, uygulamanız odağı menü çubuğuna döndürmez. Bu ayarı değiştirmek için CMFCPopupMenu::SetForceMenuFocus kullanın.

CMFCPopupMenu::GetForceShadow

static BOOL __stdcall GetForceShadow();

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetHMenu

Ekli menü kaynağına bir tanıtıcı döndürür.

HMENU GetHMenu();

CMFCPopupMenu::GetMenuBar

Açılır menünün içine eklenmiş CMFCPopupMenuBar değerini döndürür.

virtual CMFCPopupMenuBar* GetMenuBar();

Dönüş Değeri

Eklenmiş CMFCPopupMenuBaröğesinin işaretçisi.

Açıklamalar

Açılır menüde eklenmiş CMFCPopupMenuBar bir nesne vardır. Farklı bir katıştırılmış sınıf kullanıyorsanız türetilmiş bir sınıfta bu yöntemi geçersiz kılmanız gerekir.

CMFCPopupMenu::GetMenuItem

Belirtilen dizindeki menü öğesine bir işaretçi döndürür.

CMFCToolBarMenuButton* GetMenuItem(int iIndex) const;

Parametreler

iIndex
[in] Bir menü öğesinin sıfır tabanlı dizini.

Dönüş Değeri

Menü öğesinin işaretçisi. Dizin geçersizse NULL.

Açıklamalar

Menü öğeleri CMFCToolBarMenuButton Sınıfı tarafından temsil edilir. Bu yöntemi çağırdığınızda, uygun CMFCToolBarMenuButtonöğesine bir işaretçi döndürür.

CMFCPopupMenu::GetMenuItemCount

Açılır menüdeki öğelerin sayısını döndürür.

int GetMenuItemCount() const;

Dönüş Değeri

Menüdeki öğe sayısı.

CMFCPopupMenu::GetMessageWnd

Çerçevenin açılır menü iletilerini yönlendirdiği pencereye bir işaretçi döndürür.

CWnd* GetMessageWnd() const;

Dönüş Değeri

Açılan menü iletilerini alan pencere işaretçisi; Pencere yoksa NULL.

Açıklamalar

Açılır menü oluşturmak için CMFCPopupMenu::Create yöntemini kullandığınızda, menü iletilerini hangi pencerenin alacağını belirtirsiniz.

CMFCPopupMenu::GetParentArea

virtual CWnd* GetParentArea(CRect& rectParentBtn);

Parametreler

[in] rectParentBtn

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetParentButton

Üst araç çubuğu düğmesinin işaretçisini döndürür.

CMFCToolBarMenuButton* GetParentButton() const;

Dönüş Değeri

Üst araç çubuğu düğmesinin işaretçisi. Açılır menüde üst araç çubuğu düğmesi yoksa NULL.

Açıklamalar

A CMFCPopupMenu , menüdeki bir düğmeyle ilişkilendirilebilir. Bu senaryoda, bir kullanıcı üst araç çubuğu düğmesini seçtiğinde açılır menü görüntülenir.

Açılır menü bir kısayol menüsüyse, üst araç çubuğu düğmesi yoktur.

CMFCPopupMenu::GetParentPopupMenu

Üst açılır menüye yönelik bir işaretçi döndürür.

CMFCPopupMenu* GetParentPopupMenu() const;

Dönüş Değeri

Üst CMFCPopupMenu nesnenin işaretçisi; Üst açılır menü yoksa NULL.

Açıklamalar

Açılır menüde yalnızca alt menü olduğunda bir üst CMFCPopupMenu nesne vardır.

CMFCPopupMenu::GetParentRibbonElement

CMFCRibbonBaseElement* GetParentRibbonElement() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetParentToolBar

Üst araç çubuğuna bir işaretçi döndürür.

CMFCToolBar* GetParentToolBar() const;

Dönüş Değeri

Üst araç çubuğunun işaretçisi. Açılır menüde üst araç çubuğu yoksa NULL.

Açıklamalar

CMFCPopupMenu kısayol menüsü ise, üst araç çubuğu yoktur.

CMFCPopupMenu::GetQuickCustomizeType

QUICK_CUSTOMIZE_TYPE GetQuickCustomizeType() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetSelItem

Seçili durumdaki menü komutunun işaretçisini döndürür.

CMFCToolBarMenuButton* GetSelItem();

Dönüş Değeri

Seçili durumdaki menü komutunun işaretçisi; Hiçbir öğe seçilmediyse NULL.

Açıklamalar

Açılır menüdeki menü komutları, CMFCToolBarMenuButton Sınıfı veya öğesinden CMFCToolBarMenuButtontüretilen bir sınıf tarafından temsil edilir.

CMFCPopupMenu::HasBeenResized

BOOL HasBeenResized() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::HideRarelyUsedCommands

Açılır menünün nadiren kullanılan komutları gizleyip gizleyemeyeceğini gösterir.

BOOL HideRarelyUsedCommands() const;

Dönüş Değeri

Açılır menü nadiren kullanılan komutları gizleyebilirse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem yalnızca bir açılır menünün nadiren kullanılan komutları gizleyip gizleyemeyeceğini belirtir; yapılandırma etkinse gizlenemez. Bir açılır menü, üst düğmesi varsa ve üst pencere CMFCMenuBar Sınıfından türetilmişse nadiren kullanılan komutları gizleyebilir. Bu özelliği etkinleştirmek için CMFCMenuBar::SetRecentlyUsedMenus ve bu özelliğin şu anda etkin olup olmadığını belirlemek için CMFCMenuBar::IsRecentlyUsedMenus kullanın. Üst pencere için bu yöntemlerin ikisini de çağırmalısınız.

CMFCPopupMenu::InCommand

virtual BOOL InCommand();

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::InsertItem

Belirtilen konumdaki açılır menüye yeni bir öğe ekler.

int InsertItem(
    const CMFCToolBarMenuButton& button,
    int iInsertA = -1);

Parametreler

düğme
[in] Eklenecek menü öğesine başvuru.

iInsertAt
[in] Yeni öğe için sıfır tabanlı dizin. iInsertAt -1 ise, öğe menünün sonuna eklenir.

Dönüş Değeri

Öğenin eklendiği konumun sıfır tabanlı dizini. Yöntem başarısız olursa -1.

Açıklamalar

iInsertAt için şu anda açılır menüde bulunan öğe sayısından büyük bir tamsayı gibi geçersiz bir değer sağlarsanız bu yöntem başarısız olur.

CMFCPopupMenu::InsertSeparator

Belirtilen konumdaki açılır menüye bir ayırıcı ekler.

int InsertSeparator(int iInsertAt = -1);

Parametreler

iInsertAt
[in] Bu yöntemin ayırıcıyı eklediği konumun sıfır tabanlı dizini.

Dönüş Değeri

Ayırıcının eklendiği konumun sıfır tabanlı dizini. Bu yöntem başarısız olursa -1.

Açıklamalar

iInsertAt için -1 değeri, bu yöntemin ayırıcıyı açılır menünün sonuna ekleyeceğini gösterir.

iInsertAt geçersiz bir değerse bu yöntem başarısız olur.

CMFCPopupMenu::IsAlwaysClose

virtual BOOL IsAlwaysClose() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::IsAlwaysShowEmptyToolsEntry

static BOOL __stdcall IsAlwaysShowEmptyToolsEntry();

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::IsCustomizePane

Açılır menünün QuickCustomizePane olarak çalışıp çalışmadığını gösterir.

BOOL IsCustomizePane();

Dönüş Değeri

Açılır pencere bir QuckCustomizePane ise TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Kullanıcının açılır menüyü doğrudan özelleştirmesini sağlamak için QuickCustomizePane'ı kullanın. QuickCustomizePane, kullanıcı doğrudan düzenlemek için bir araç çubuğu düğmesine tıkladığında görüntülenen bir düğmedirCMFCPopupMenu.

Uygulamanız CMDIFrameWndEx::OnShowCustomizePane sırasında bu yöntemi çağırmalıdır.

CMFCPopupMenu::IsEscClose

BOOL IsEscClose();

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::IsIdle

Bir açılır menünün şu anda boşta olup olmadığını gösterir.

virtual BOOL IsIdle() const;

Dönüş Değeri

Açılır menü boşta modundaysa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Varsayılan olarak, görüntü animasyonu tamamlandıysa ve kullanıcı açılır menüyü kaydırmıyorsa bir açılır menü boşta modundadır.

CMFCPopupMenu::IsMenuSound

static UINT __stdcall IsMenuSound();

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::IsQuickCustomize

İlişkili CMFCToolBarMenuButton Sınıfının QuickCustomize modunda olup olmadığını belirler.

BOOL IsQuickCustomize();

Dönüş Değeri

İlişkili menü düğmesi QuickCustomize modundaysa TRUE; aksi takdirde YANLIŞ. Bu yöntem, açılır menü ile CMFCToolBarMenuButtonilişkilendirilmemişse YANLIŞ değerini de döndürür.

Açıklamalar

QuickCustomize modunda kullanıcı, düğmeyi doğrudan özelleştirmek için araç çubuğundaki bir düğmeyi seçer.

CMFCPopupMenu::IsResizeble

BOOL IsResizeble() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::IsRightAlign

Menünün sağa mı yoksa sola mı hizalı olduğunu gösterir.

BOOL IsRightAlign() const;

Dönüş Değeri

Menü sağa hizalıysa TRUE; Menü sola hizalıysa YANLIŞ.

Açıklamalar

Menü hizalamasını ayarlamak için CMFCPopupMenu::SetRightAlign kullanabilirsiniz. Varsayılan olarak, açılır menülerde sol hizalama kullanılır.

Menü hizalaması genel bir ayar değildir ve açılır menüler arasında farklılık gösterebilir.

CMFCPopupMenu::IsScrollable

BOOL IsScrollable() const;

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::IsSendMenuSelectMsg

Kullanıcı açılır menüden bir komut seçtiğinde çerçevenin üst çerçeveyi bilgilendirip uyarmadığını gösterir.

static BOOL IsSendMenuSelectMsg();

Dönüş Değeri

Çerçeve üst çerçeveye bildirirse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Çerçeve, kullanılan bir menü komutu seçtiğinde üst çerçeveye WM_MENUSELECT iletisi göndererek bunu bildirir.

CMFCPopupMenu::IsShown

Açılır menünün şu anda görünür olup olmadığını gösterir.

BOOL IsShown() const;

Dönüş Değeri

Bir açılır menü görünür durumdaysa TRUE; aksi takdirde YANLIŞ.

CMFCPopupMenu::MoveTo

void MoveTo(const CPoint& pt);

Parametreler

[in] Pt

Açıklamalar

CMFCPopupMenu::OnChangeHot

virtual void OnChangeHot(int nHot);

Parametreler

[in] nHot

Açıklamalar

CMFCPopupMenu::OnChooseItem

virtual void OnChooseItem(UINT uidCmdID);

Parametreler

[in] uidCmdID

Açıklamalar

CMFCPopupMenu::OnCmdMsg

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parametreler

[in] Nıd
[in] nCode
[in] pExtra
[in] pHandlerInfo

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::P ostCommand

BOOL PostCommand(UINT uiCommandID);

Parametreler

[in] uiCommandID

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametreler

[in] pMsg

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::RecalcLayout

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametreler

[in] bNotify

Açıklamalar

CMFCPopupMenu::RemoveAllItems

Açılır menüden tüm öğeleri temizler.

void RemoveAllItems();

CMFCPopupMenu::RemoveItem

Belirtilen öğeyi açılır menüden kaldırır.

BOOL RemoveItem(int iIndex);

Parametreler

iIndex
[in] Silinecek öğenin sıfır tabanlı dizini.

Dönüş Değeri

Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, bir öğenin kaldırılmasından etkilenen tüm ayırıcıları otomatik olarak düzenler. Çerçevenin ayırıcıları yeniden düzenlemesi hakkında daha fazla bilgi için bkz . CMFCToolBar::RemoveButton.

CMFCPopupMenu::SaveState

virtual void SaveState();

Açıklamalar

CMFCPopupMenu::SetAnimationSpeed

Açılır menüler için animasyon hızını ayarlar.

static void SetAnimationSpeed(UINT nElapse);

Parametreler

nElapse
[in] Milisaniye cinsinden yeni animasyon hızı.

Açıklamalar

Animasyon hızı genel bir değerdir ve uygulamadaki tüm açılır menüleri etkiler. Bu değer, bir açılır menünün animasyonunun ne kadar süreceğini belirtir.

Varsayılan olarak, bu parametre 30 milisaniye olarak ayarlanır. nElapse için geçerli değer aralığı 0 ile 200 arasındadır.

CMFCPopupMenu::SetAnimationType

Bu açılır menü için animasyon türünü ayarlar.

static void SetAnimationType(CMFCPopupMenu::ANIMATION_TYPE type);

Parametreler

type
[in] Animasyon türünü belirten numaralandırılmış veri türü.

Açıklamalar

Türü için geçerli değerlerin listesi için bkz. CMFCPopupMenu::GetAnimationType.

CMFCPopupMenu::SetAutoDestroy

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Parametreler

[in] bAutoDestroy

Açıklamalar

CMFCPopupMenu::SetDefaultItem

Açılır menü için varsayılan komutu ayarlar.

void SetDefaultItem(UINT uiCmd);

Parametreler

uiCmd
[in] Yeni varsayılan komutun menü komut kimliği.

Açıklamalar

Açılır menüdeki varsayılan komut, açılır menü görüntülendiğinde seçilen komutdur.

CMFCPopupMenu::SetForceMenuFocus

Açılır menü görüntülendiğinde giriş odağını menü çubuğuna dönmeye zorlar.

static void SetForceMenuFocus(BOOL bValue);

Parametreler

bValue
[in] Bir açılır menü görüntülendiğinde çerçevenin giriş odağını menü çubuğuna zorlamasını istiyorsanız TRUE. Açılan menünün odağı korumasını istiyorsanız YANLIŞ.

Açıklamalar

Bu yöntem, uygulamadaki tüm açılır menüler için genel bir bayrak ayarlar. Varsayılan olarak, bu özellik etkin değildir.

CMFCPopupMenu::SetForceShadow

Açılır menüler ana çerçevenin dışında göründüğünde çerçeveyi menü gölgeleri çizmeye zorlar.

static void SetForceShadow(BOOL bValue);

Parametreler

bValue
[in] Çerçevenin menü gölgeleri çizmesini istiyorsanız TRUE, aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntemi çağırdığınızda, uygulamanızda genel bir bayrak ayarlar. Bu bayrak, uygulamanızdaki tüm açılır menüleri etkiler.

CMFCPopupMenu::SetMaxWidth

Açılır menü için en yüksek genişliği ayarlayın.

void SetMaxWidth(int iMaxWidth);

Parametreler

iMaxWidth
[in] Açılır menü için piksel cinsinden maksimum genişlik.

Açıklamalar

Menü komutuyla ilişkilendirilmiş metin en büyük genişliğe sığmazsa kesilir ve sığmayan kısım üç noktayla değiştirilir.

CMFCPopupMenu::SetMessageWnd

void SetMessageWnd(CWnd* pMsgWnd);

Parametreler

[in] pMsgWnd

Açıklamalar

CMFCPopupMenu::SetParentRibbonElement

void SetParentRibbonElement(CMFCRibbonBaseElement* pElem);

Parametreler

[in] pElem

Açıklamalar

CMFCPopupMenu::SetQuickCustomizeType

void SetQuickCustomizeType(QUICK_CUSTOMIZE_TYPE Type);

Parametreler

[in] Tür

Açıklamalar

CMFCPopupMenu::SetQuickMode

void SetQuickMode();

Açıklamalar

CMFCPopupMenu::SetRightAlign

Açılır menüler için menü hizalamasını ayarlar.

void SetRightAlign(BOOL bRightAlign = TRUE);

Parametreler

bRightAlign
[in] Menü hizalamasını gösteren Boole değeri. DOĞRU, sağ hizalamayı, YANLIŞ ise sol hizalamayı gösterir.

Açıklamalar

Varsayılan olarak, tüm açılır menüler sola hizalanır.

CMFCPopupMenu::SetSendMenuSelectMsg

Kullanıcı bir komut seçtiğinde açılır menünün üst çerçevesini bilgilendirip bilgilendirmeyeceğini denetleyen bir bayrak ayarlar.

static void SetSendMenuSelectMsg(BOOL bSet = TRUE);

Parametreler

bSet
[in] Açılır menü üst çerçevesini bildirirse TRUE, aksi takdirde YANLIŞ.

Açıklamalar

Bu, bir uygulamadaki tüm açılır menüler için genel bir seçenektir. Etkinleştirilirse, açılır menüler kullanıcı bir komut seçtiğinde üst çerçeveye bir WM_MENUSELECT iletisi gönderir.

CMFCPopupMenu::ShowAllCommands

Açılır menüyü tüm komutları görüntülemeye zorlar.

void ShowAllCommands();

Açıklamalar

Bu genel bir ayar değildir ve yalnızca geçerli açılır menüyü etkiler.

CMFCPopupMenu::TriggerResize

void TriggerResize();

Açıklamalar

CMFCPopupMenu::UpdateAllShadows

Tüm açılan menülerin gölgelerini güncelleştirir.

static void UpdateAllShadows(LPRECT lprectScreen = NULL);

Parametreler

lprectScreen
[in] Güncelleştirilecek bölgeyi ekran koordinatlarında belirten bir dikdörtgen.

Açıklamalar

Bu yöntem, açılır menüler animasyonlu denetimler veya dinamik içeriğe sahip diğer pencereler üzerinde görüntülendiğinde kullanışlıdır.

CMFCPopupMenu::UpdateShadow

Açılır menünün gölgesini güncelleştirir.

void UpdateShadow(LPRECT lprectScreen = NULL);

Parametreler

lprectScreen
[in] Güncelleştirilecek bölgenin sınırlarını belirten ekran koordinatlarında bir dikdörtgen.

Açıklamalar

Gölge içeren bir açılır menü animasyonlu görüntüyle çakıştığında bu yöntemi çağırabilirsiniz.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCPopupMenuBar Sınıfı

Aracılığıyla paylaş

CMFCPopupMenu Sınıfı

Sözdizimi

Üyeler

Korumalı Oluşturucular

Genel Yöntemler

Korumalı Yöntemler

Açıklamalar

Örnek

Devralma Hiyerarşisi

Gereksinimler

CMFCPopupMenu::ActivatePopupMenu

Parametreler

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::AlwaysShowEmptyToolsEntry

Parametreler

CMFCPopupMenu::AreAllCommandsShown

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::CheckArea

Parametreler

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::CloseMenu

Parametreler

Açıklamalar

CMFCPopupMenu::CMFCPopupMenu

Parametreler

Açıklamalar

CMFCPopupMenu::Create

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CMFCPopupMenu::CreateTearOffBar

Parametreler

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::D efaultMouseClickOnClose

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::EnableMenuLogo

Parametreler

Açıklamalar

CMFCPopupMenu::EnableMenuSound

Parametreler

Açıklamalar

CMFCPopupMenu::EnableResize

Parametreler

Açıklamalar

CMFCPopupMenu::EnableScrolling

Parametreler

Açıklamalar

CMFCPopupMenu::EnableVertResize

Parametreler

Açıklamalar

CMFCPopupMenu::FindSubItemByCommand

Parametreler

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetActiveMenu

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetAnimationSpeed

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetAnimationType

Parametreler

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetDropDirection

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetForceMenuFocus

Dönüş Değeri

Açıklamalar

CMFCPopupMenu::GetForceShadow

Dönüş Değeri

Açıklamalar