IDL MFC yöntemi ekleme

IDL MFC Yöntemi Ekleme sihirbazı, Microsoft Framework Sınıfı (MFC) projenizde tanımlanan Arabirim Tanımı Kitaplığı (IDL) arabirimine bir yöntem ekler. Proje arabirimle ilişkilendirilmiş bir sınıf içeriyorsa, sihirbaz da yöntemini sınıfına ekler.

Bu sihirbazı kullanmak için MFC Projesinde, ActiveX projesinde veya MFC'yi destekleyen bir ATL projesinde olmanız gerekir. Örneğin, bir Microsoft ActiveX denetim projeniz varsa, çözümdeki bir IDL arabirimine yöntem eklemek için aşağıdaki yordamı kullanabilirsiniz.

Bu sihirbaz, Yöntem Ekleme sihirbazından (IDL arabirimine yöntem ekleyen) aşağıdaki yollarla farklıdır:

  • MFC' yi destekleyen MFC, ActiveX veya ATL projelerine özgüdür. MFC'yi desteklemeyen ATL projeleri için yalnızca Yöntem Ekleme sihirbazı kullanılabilir.

  • Projede bir Dispatch eşlemesi bulunursa aşağıdaki girişleri ekler:

    BEGIN_DISPATCH_MAP(CMFCApplication2Doc, CDocument)
        DISP_FUNCTION_ID(CMFCApplication2Doc, "methodName", dispidmethodName, internalName, VT_EMPTY, VTS_NONE)
    END_DISPATCH_MAP()
    
  • Aşağıdaki ilişkili yöntem uygulamasını oluşturur:

    void CMFCApplication2Doc::internalName()
    {
         AFX_MANAGE_STATE(AfxGetAppModuleState());
         // TODO: Add your dispatch handler code here
    }
    

Arabirime yöntem ekleme

  1. Görünüm menüsünde Sınıf Görünümü'nü seçin.

  2. Sınıf Görünümü'nde, yöntemini eklemek istediğiniz arabirimi görüntülemek için proje düğümünü genişletin.

  3. Arabirimin adına sağ tıklayın.

  4. Kısayol menüsünde Ekle'yi ve ardından Yöntem Ekle'yi seçin.

  5. IDL MFC Yöntemi Ekleme sihirbazında yöntem hakkında bilgi sağlayın.

  6. Yöntemi eklemek için Tamam'ı seçin.

UI öğe listesi

Aşağıdaki bölümde IDL MFC Yöntemi Ekleme sihirbazı kullanıcı arabirimi açıklanmaktadır:

Sihirbaz kullanıcı arabirimi. Yöntem adı:DoClick, İç ad:DoClick, Dönüş türü:void, Yöntem türü:özel, Parametreler:long l, char C, Öznitelikler kimliği:1.

  • Yöntem adı

    yönteminin adını ayarlayın. Aşağıdaki tabloda, arabirim türüne bağlı olarak yöntem adı seçenekleri açıklanmaktadır:

    Arabirim türü Yöntem adı
    ATL çift arabirimi, özel arabirim ve yerel özel arabirim Kendi yöntem adınızı girin.
    MFC dispinterface Kendi yöntem adınızı girin veya listeden önerilen yöntem adını seçin. Listeden bir ad seçerseniz, uygun dönüş türü Dönüş türü'nde görünür ve değiştirilemez.
    MFC ActiveX denetimi dispinterface Kendi yöntem adınızı girin veya stok yöntemlerinden birini seçin: DoClick veya Refresh. Hisse senedi yöntemleri hakkında daha fazla bilgi için bkz . MFC ActiveX denetimleri: Stok yöntemleri ekleme.
  • İç ad

    Yalnızca Yöntem türü özel olduğunda kullanılabilir. İç ad , dağıtım eşlemesinde, üst bilgi (.h) dosyasında ve uygulama (.cpp) dosyasında kullanılacak addır. Varsayılan olarak, bu ad Yöntem adı ile aynıdır. MFC dispinterface'e eklenir.

    yöntemini bir MFC veya MFC ActiveX denetimi dispinterface'e ekliyorsanız, yöntem adını aşağıdaki tabloda açıklandığı gibi değiştirebilirsiniz:

    Arabirim türü İç ad
    ATL çift arabirimi, özel arabirim ve yerel özel arabirim Kullanılamaz.
    MFC dispinterface Varsayılan olarak yöntem adına ayarlayın. İç adı düzenleyebilirsiniz.
    MFC ActiveX denetimi dispinterface İç adı yalnızca özel yöntemler için ayarlayabilirsiniz. Hisse senedi yöntemleri iç ad kullanmaz.
  • Dönüş türü

    yöntemi tarafından döndürülen veri türü. Arabirim yöntemleri için standart dönüş türü şeklindedir HRESULT.

    Arabirim çift arabirim veya özel arabirimse, yalnızca dönüş türüne HRESULT izin verilir.

    Veri türünü, aşağıdaki tabloda açıklandığı gibi yöntemin eklendiği arabirim türüne göre ayarlayabilirsiniz:

    Arabirim türü Dönüş türü
    Çift arabirim HRESULT. Değişmez.
    Özel arabirim HRESULT. Değişmez.
    Yerel özel arabirim Kendi dönüş türünüzü belirtin veya listeden bir tane seçin.
    Dispinterface Kendi dönüş türünüzü belirtin veya listeden bir tane seçin.
    MFC ActiveX denetimi dispinterface Bir hisse senedi yöntemi uygularsanız, dönüş türü uygun değere ayarlanır ve değiştirilemez. Yöntem adı listesinden bir yöntem seçtiyseniz ve Yöntem türünü seçin altında Özel'i seçerseniz, listeden bir dönüş türü seçin.
  • Yöntem türü

    Yalnızca MFC ActiveX denetimleri için kullanılabilir. Listeden bir yöntem seçmek yerine Yöntem adında bir yöntem adı sağladıysanız kullanılamaz.

    Yöntem adı listesindeki yöntemlerden birini seçerseniz, Yöntem türü açılan listesinde Hisse Senedi veya Özel uygulamasını seçin. Yöntemin seçilmesi, sihirbazın sağladığı dönüş türünü ve yöntem uygulamasını aşağıdaki tabloda açıklandığı gibi etkiler:

    Yöntem türü Açıklama
    Stok Varsayılan. Yöntem adı listesinde seçilen yöntemin varsayılan uygulamasını ekler. Hisse Senedi'yi seçerseniz iade türü değiştirilemez.
    Özel Yöntem adı'nda seçilen yöntem için özel bir uygulama sağlarsınız. Kendi dönüş türünüzü sağlayabilir veya Dönüş türü listesinden birini seçebilirsiniz.
  • Parametreler

    Yöntemin parametrelerini, değiştiricilerini ve türlerini görüntüler. Siz parametre eklerken sihirbaz Parametreler listesini güncelleştirir.

  • +

    Parametre ekleyin. Parametreler'de parametre türünü, adını ve değiştiricileri yazın. Örneğin, int xve Tamam'ı seçin.

    Parametre adı sağlamazsanız, sihirbaz parametre türü seçimlerini yoksayar ve ATL projeleri için parametre öznitelikleri de yoksayılır.

  • x

    Seçili parametreyi Parametreler listesinden kaldırır.

  • Kalem simgesi

    Seçili parametreyi düzenleyin.

  • id

    Yöntemini tanımlayan sayısal kimliği ayarlar. Daha fazla bilgi için MIDL başvurusuna bakınid.

  • call_as

    Bu yerel yöntemle eşlemek için uzak yöntemin adını belirtir. Daha fazla bilgi için MIDL başvurusuna bakıncall_as.

  • helpcontext

    Kullanıcının Yardım dosyasında bu yöntemle ilgili bilgileri görüntülemesine olanak tanıyan bir bağlam kimliği belirtir. Daha fazla bilgi için MIDL başvurusuna bakınhelpcontext.

  • helpstring

    İlişkili öğeyi açıklayan bir metin belirtir. Varsayılan olarak Yöntem adıdır. Daha fazla bilgi için MIDL başvurusunda helpstring bölümüne bakın.

Ayrıca bkz.

Yöntem ekleme sihirbazı
IDL yöntemi ekleme sihirbazı
MFC sihirbazları ve iletişim kutuları