Döndürmesini

Döndürmesini işlev yeni öğe belirtilen menü çubuğu, açılır menüsünü, alt menü veya kısayol menüsünü sonuna. İçerik, görünüm ve menü öğesinin davranışını belirlemek için bu işlevi kullanabilirsiniz.

InsertMenuItem işlevi tarafından döndürmesini işlev bırakmıştır. Eğer sen yapmak değil lüzum birisi InsertMenuItem genişletilmiş özellikleri döndürmesini, ancak kullanmaya devam edebilirsiniz.

 bool döndürmesini) HMENU'nun  HMENU'nun, / / idare değiştirilecek menüUINTuFlags, / / menü öğesi flagsUINTuIDNewItem, / / menü öğesi tanıtıcısı veya açılır menü veya alt menü için tanıtıcılpctstrlpNewItem / / menü öğesinin içeriği);

Parametreleri

hMENU'nun

Menü çubuğu, açılır menü, alt veya değiştirilmesi için kısayol menüsü için kolu.

uFlags

Yeni menü öğesinin davranışını ve görünümünü denetlemek için bayrakları belirtir. Bu parametreyi aşağıdaki açıklamalar bölümünde listelenen değerleri birleşimi olabilir.

uIDNewItem

Yeni bir menü öğesi tanıtıcısı belirtir veya mf_popup, açılır menü veya alt menü için tanıtıcı uFlags parametre ayarlanmışsa.

lpNewItem

Yeni menü öğesinin içeriğini belirtir. LpNewItem yorumu olup uFlags parametre MF_BITMAP, mf_ownerdraw ya da MF_STRING bayrak içerir üzerinde bağlıdır:

Değer	Açıklama
MF_BITMAP	Biteşlem tutamacı içeren.
MF_OWNERDRAW	Menü öğesine ilgili ek verileri korumak için kullanılan uygulama tarafından sağlanan 32 bitlik bir değer içerir. wm_measure lparam parametresinin tarafından işaret yapısı ya da WM_DRAWITEM mesaj menüsü oluşturulur veya görünümü güncelleştirildiğinde gönderilir ItemData üyesi değerdir.
MF_STRING	Bir boş sonlandırılmış dize bir işaretçi içerir.

Dönüş değerleri

İşlev başarılı olursa, dönüş değeri sıfır.

İşlev başarısız olursa, dönüş değeri sıfırdır. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

Uygulama menüsü görüntülenen pencerede olup olmadığını bir menü değiştiğinde, DrawMenuBar işlevi çağırmalıdır.

Bit eşlem veya sahibi çizilmiş menü öğeleri ile çalışmak için klavye hızlandırıcıları almak için menü sahibi wm_menuchar ileti işlemeniz gerekir. Daha fazla bilgi için bkz: Owner-Drawn menüler ve wm_menuchar ileti.

Aşağıdaki bayraklardan uFlags parametre ayarlayabilirsiniz:

Değer	Açıklama
MF_BITMAP	Bit eşlem menü öğesini kullanır. LpNewItem parametresi, bitmap için tanıtıcı içerir.
MF_CHECKED	Menü öğesinin yanında bir onay işareti koyar. Uygulama, onay işareti bitmapler (bkz. SetMenuItemBitmaps, menü öğesinin yanındaki onay işaretini bitmap bayrak görüntülenir sağlar,.
MF_DISABLED	Menü öğesi seçilemez, ancak bayrağı o gri değil devre dışı bırakır.
MF_ENABLED	Böylece seçilebilir ve gri durumuna yükler menü öğesi sağlar.
MF_GRAYED	Menü öğesi devre dışı bırakır ve bu nedenle seçilemez grays.
MF_MENUBARBREAK	İşlevleri gibi mf_menubreak için bir menü çubuğu bayrak. Bir açılır menü, alt menü veya kısayol menüsü için yeni bir sütun eski sütun dikey çizgiyle ayrılır.
MF_MENUBREAK	(Menü çubuğu için) yeni bir satır öğesi yerleştirir veya sütunlarını ayıran olmadan yeni bir sütun (için açılır menü, alt menü veya kısayol menüsü).
MF_OWNERDRAW	Madde sahibi çizilmiş bir madde olduğunu belirtir. İlk kez menü görüntülenmeden önce Menü sahibi penceresinin genişliğini ve yüksekliğini menü öğesinin almak için bir WM_MEASUREITEM iletisi alır. Menü öğesinin görünümünü güncelleştirilmesi gereken her WM_DRAWITEM mesaj sonra sahibi penceresinin pencere yordamı gönderilir.
MF_POPUP	Menü öğesi bir açılır menüyü veya alt menüyü açar belirtir. UIDNewItem parametresi, açılır menü veya alt menü tanıtıcısını belirtir. Bu bayrak, bir menü çubuğu veya bir açılır menü, alt menü veya kısayol menüsü için bir alt menü açılır bir menüde menü adı eklemek için kullanılır.
MF_SEPARATOR	Yatay çizgi çizer. Bu bayrak, yalnızca bir açılır menü, alt menü veya kısayol menüsü kullanılır. Satır gri, devre dışı, vurgulanan veya değiştirilemez. LpNewItem ve uIDNewItem parametreleri yoksayılır.
MF_STRING	Menü öğesi bir metin dizesi belirtir; lpNewItem parametresinin dizeye işaret eder.
MF_UNCHECKED	(Varsayılan) öğesinin yanındaki onay işareti yerleştirmez. Uygulama onay işareti bitmapler (bkz. SetMenuItemBitmaps) sağlarsa, bu bayrak menü öğesinin yanındaki denetlenmeyen bitmap görüntüler.

Aşağıdaki gruplar bayrakları birlikte kullanılamaz:

MF_DISABLED, mf_enabled ve mf_grayed
MF_BITMAP, MF_STRING ve mf_ownerdraw
Mf_menubarbreak ve mf_menubreak
Mf_checked ve mf_unchecked

Windows ce: Aşağıdaki bayraklardan fuFlags parametresi için desteklenmez

MF_BITMAP

MF_DISABLED

MFS_GRAYED

Mf_grayed MF_DISABLED ve mfs_grayed yerine kullanılabilir.

Windows ce 1.0 basamaklı menüleri desteklemez. Windows ce 1.0 kullanıyorsanız, başka bir açılır menü bir mf_popup menü ekleyemezsiniz.

Windows ce 1.0 içinde aşağıdaki bayraklar desteklenmez:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

Windows ce sürüm 2.0 ve daha sonra bu bayrakları desteklenir. Basamaklı menüler de desteklenir.

Ayrıca bkz:

Menüler genel bakış, menü işlevleri, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index