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:

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