InsertMenu

InsertMenu işlevi bir menü, menü diğer öğeleri taşıma yeni bir menü öğesi ekler.

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

bool InsertMenu ()  HMENU'nun  HMENU'nun, / / işlemek için MenüUINTuPosition, / / menü öğesi bu yeni menü öğesi önündekiUINTuFlags, / / menü öğesi flagsUINTuIDNewItem, / / menü madde tanımlayıcısı veya işlemek için açılan / / menü veya alt menülpctstrlpNewItem / / menü madde içeriği);

Parametreleri

hMENU'nun

Değiştirilmesi için menüsüne ele.

uPosition

Önce yeni bir menü öğesi eklenmesini, uFlags parametresi tarafından belirlenen olan menü öğesini belirtir.

uFlags

UPosition parametre ve içeriği, görünümünü ve davranışını yeni bir menü öğesi yorumu denetleyen bayraklar belirtir. Bu parametreyi aşağıdaki gereken değerlerden biri ve en az bir aşağıdaki açıklamalar bölümünde listelenen değerleri birleşimi olmalıdır.

Değer	Açıklama
MF_BYCOMMAND	UPosition parametresi menü öğesi tanıtıcısı sağlar gösterir. Ne mf_bycommand ne de MF_BYPOSITION bayrağı belirtilmişse mf_bycommand bayrağı varsayılan değerdir.
MF_BYPOSITION	UPosition parametresi yeni bir menü öğesi sıfır tabanlı göreceli konumunu verir belirtir. UPosition 0xFFFFFFFF ise, yeni bir menü öğesi menü sonuna eklenir.

uIDNewItem

Yeni bir menü öğesi tanıtıcısı belirtir ya da uFlags parametre varsa mf_popup bayrağını ayarlayın, açılır menü veya alt menü için tanıtıcı.

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_MEASUREITEM lparam parametresinin tarafından işaret yapısını veya menü öğesi oluşturulduğunda veya görünüşünü gönderilip WM_DRAWITEM mesaj ItemData üyesi değerdir.
MF_STRING	Bir boş sonlandırılmış dize (varsayılan) gösteren bir işaretçi içeren.

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.

Aşağıdaki liste, uFlags parametresinde ayarlanan bayrakları açıklar.:

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) sağlar, bu bayrak menü öğesinin yanına onay işareti bitmap görüntüler.
MF_DISABLED	Böylece seçilemez, ancak o gri değil menü öğesini devre dışı bırakır.
MF_ENABLED	Böylece o 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ü çubukları 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) menü öğesinin yanına onay işareti koyun değil. Uygulama onay işareti bitmapler (bkz: SetMenuItemBitmaps işlevi) sağlarsa, bu bayrak menü öğesinin yanındaki denetlenmeyen bitmap görüntüler.

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

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

Windows ce: Windows ce MF_BITMAP bayrağı ya da MF_DISABLED bayrağı uFlags parametresini desteklemez. Gri olmadan menü öğeleri devre dışı bırakılamaz. Bir menü öğesini kullanarak devre dışı mf_grayed bayrağı.

Windows ce sürüm 1.0 basamaklı menüleri desteklemez. Windows ce 1.0 kullanıyorsanız, başka bir açılır menü bir mf_popup menüye ekleyemezsiniz. Windows ce 2.0 veya sonraki sürümünü kullanarak yapabilirsiniz.

Ayrıca bkz:

Menüler genel bakış, menü işlevleri, döndürmesini, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index