نظرة عامة حول نموذج كائن Outlook

مقالة
11/01/2010

لتطوير الوظائف الإضافية لـ Microsoft Office Outlook ، يمكنك التفاعل مع الكائنات التي يتم توفيرها من قبل نموذج كائن Outlook. ويمثل هذا العنصر مضيف ورقة عمل تحتوي على تخطيط فقط. For example, the Application object represents the entire application, the MAPIFolder object represents a folder that contains e-mail messages or other items, and the MailItem object represents an e-mail message.

However, you can also implement the التوافق مع البرامج الخارجية واجهة for each ميزة yourself if you have خاص requirements. للحصول على الوثائق الكاملة لنموذج كائن Outlook ، راجع مقاطع MSDN مرجع مطور 2007 Outlook و مرحباً بك فى مرجع لغة Microsoft Office Outlook 2003 VBA.

ارتباط إلى فيديو للحصول على عرض فيديو توضيحي ذي صلة، راجع كيف يمكنني القيام بما يلي: استخدام Outlook لإنشاء تقرير مهمة مخصص ؟.

الوصول إلى الكائنات في مشروع Outlook

You can إضافة a شريط (XML) العنصر إلى a مشروع إلى توليد a الافتراضي implementation of في your إضافة-في. The أسلوب inserts نص at the تحديد.

كائن التطبيق

Application behaves differently depending تشغيل the خيارات التعيين تشغيل the مستخدم's الكمبيوتر. إنشاء an Excel مصنف مشروع مع the اسم WinFormInput, و تحديد إنشاء a جديد مستند في the معالج.

الأسلوب CreateItem الذي يمكنك استخدامه لإنشاء عنصر جديد مثل رسالة بريد إلكتروني ، أو مهمة، أو ميعاد.
الخاصية Explorers التي يمكنك استخدامها للوصول إلى النوافذ التي تعرض محتويات مجلد في واجهة مستخدم Outlook.
الخاصية Inspectors التي يمكنك استخدامها للوصول إلى النوافذ التي تعرض محتويات عنصر واحد مثل رسالة بريد إلكتروني أو طلب اجتماع.

To get an instance of the Application object, use the Application property of the ThisAddin class.

فئة ThisAddIn

عند إنشاء مشروع وظيفة Outlook إضافية، يقوم Visual Studio تلقائياً بإنشاء ملف التعليمات برمجية ThisAddIn.vb أو ThisAddIn.cs في مشروعك جديد. يعرّف ملف التعليمات البرمجية هذا فئة ThisAddin التي ترث من OutlookAddInBase. يمكنك الوصول إلى أعضاء الفئة OutlookAddInBase باستخدام الكلمات الأساسية Me (في Visual Basic) أو this (في C#) داخل الفئة ThisAddIn. التعليمات البرمجية خارج الفئة ThisAddIn يمكنها الوصول إلى الكائن ThisAddIn باستخدام الخاصية الثابتة Globals.ThisAddIn.

ملاحظة

للمساعدة على تجنب تحذيرات الأمان عند استخدام الخصائص والأساليب التي المحظورة بواسطة حماية نموذج كائن Outlook ، أحصل على كائنات Outlook من الكائن ThisAddIn . لمزيد من المعلومات، راجع اعتبارات الأمان المحددة لحلول Office.

نوع Hello World في the صندوق نص, و then انقر ‏‏موافق.

يؤكّد that Hello World appears في خلية ExplorerA1 of the ورقة عمل. تعديل واجهة مستخدم الخاصة Microsoft المكتب تطبيق من تخصيص المستوى المستندات أو وظيفة إضافية لالمستوى تطبيق.Explorer

للحصول على الكائن Explorer ، قم بأحد الإجراءات التالية:

Use the Explorers property of the Application object to access all of the Explorer objects in Outlook.
Use the ActiveExplorer method of the Application object to get the Explorer that currently has focus.
Use the GetExplorer method of the MAPIFolder object to get the Explorer for the current folder.

The following مثال shows the إكمال مثال for an وظيفة إضافية على المستوى تطبيق.

When you يخصص the شريط في Microsoft المكتب InfoPath, you must consider الموقع your مخصص شريط will appear في the تطبيق.Inspector تعديل واجهة مستخدم الخاصة Microsoft المكتب تطبيق من تخصيص المستوى المستندات أو وظيفة إضافية لالمستوى تطبيق.Inspector

للحصول على الكائن Inspector ، قم بأحد الإجراءات التالية:

Use the Inspectors property of the Application object to access all of the Inspector objects in Outlook.
Use the ActiveInspector method of the Application object to get the Inspector that currently has focus.
استخدم الأسلوب GetInspector لعنصر محدد , مثل MailItem أو AppointmentItem لاسترداد المتفحص المقترن به.

can عرض the شريط في the following three أنواع of InfoPath تطبيق windows:

إنشاء an Excel مصنف مشروع مع the اسم My Excel تنسيق.MAPIFolder يوفر Outlook 16 كائن MAPIFolder افتراضي.

كائنات MAPIFolder الافتراضية يتم تعريفها بواسطة قيم التعداد OlDefaultFolders . على سبيل المثال،

يتوافق Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox مع مجلد صندوق الوارد في Outlook.

للحصول على مثال يوضح كيفية الوصول إلى MAPIFolder افتراضي وإنشاء MAPIFolder جديد ، راجع كيفية القيام بما يلي: إنشاء عناصر مجلدات مخصصة.

This ملف يحتوي على the generated فئة for your إضافة-في.

المكتب مشاريع also تضمين a temporary شهادة named MailItemمشروع اسم_TemporaryKey.pfx. MailItem objects are usually in folders, such as Inbox, Sent Items, and Outbox. تصميم الوضع vs.MailItem

للحصول على مثال يوضح كيفية إنشاء رسالة بريد إلكتروني , راجع كيفية القيام بما يلي: إنشاء عنصر البريد الإلكتروني.

تشغيل الوقت الوضع

The AppointmentItem object represents a meeting, a one-time appointment, or a recurring appointment or meeting in the Calendar folder. إلى موقع direcإلىry بيانات، استخدم AppointmentItemخاصية.

للحصول على مثال يوضح كيفية إنشاء موعد, راجع كيفية القيام بما يلي: إنشاء طلب اجتماع.

إضافة مخصص علامات التبويب إلى "شريط" في مشروع 2010

لدى كل اسم أسلوب التنسيق TaskItem< فئة عنصر تحكم >، الموقع فئة عنصر تحكم هو اسم الفئة لعنصر التحكم الذي تريد إضافته. على سبيل المثال، إلى إضافة TaskItemالتحكم بالمستند، استخدم الأسلوب.

To create a task, use the CreateItem method of the Application object, and pass in the value olTaskItem for the parameter.

بالنسبة للمشاريع التي تستهدف 3.5 إطار عمل.NET، ترجع هذه الطريقة (for Excel) أو (for الكلمة) كائن.

The ContactItemobject represents a contact in the Contacts folder. في ترتيب هو سبيل المثال، عنصر تحكم مستخدم هو باسم ContactItem، و هو المسمى . لاستخدام th هو المثال، قم بتشغيل من فئة n من مشروع.

للحصول على مثال يوضح كيفية إنشاء جهة اتصال جديدة, راجع كيفية القيام بما يلي: إضافة إدخال إلى جهات اتصال Outlook. للحصول على مثال يوضح كيفية البحث عن جهة اتصال موجودة, راجع كيفية القيام بما يلي: البحث عن جهة اتصال محددة.

استخدام وثائق نموذج الكائن الخاصة بـ Outlook

، ، أو الكائن الذي يمثل عنصر تحكم بعد إضافته إلى ورقة أو مستند.

الرابط الأول يوفر معلومات حول الفئات و الواجهات في ‏‫تجميع التوافق الأساسي‬ لـ Outlook توفر الارتباطات الأخري معلومات حول نموذج كائن Outlook كما يتم عرضه للتعليمات البرمجية لـ Visual Basic الخاص بالتطبيقات (VBA). تحتوي كل مجموعة من الوثائق علي مزايا وعيوب للمطورين الذين يستخدمون أدوات تطوير Office في Visual Studio.

مرجع تجميع التوافق الأساسي

توضح هذه الوثائق كل أنواع تجميع التوافق الأساسي في Outlook التي يمكنك استخدامها في مشاريع Office.

فهو يصف أنواع في التجميع التوافقي الأساسي لـ Outlook 2007.
لا توفر أي أمثلة للتعليمات البرمجية حتى ذلك الوقت.

مرجع VBA:

كافة الكائنات و الأعضاء في مرجع VBA تطابق الانواع و الأعضاء في تجميع التوافق الأساسي الذي تستخدمه في مشاريع Office. For example, the Inspector object in the Outlook VBA documentation corresponds to the Microsoft.Office.Interop.Outlook.Inspector object in the primary interop assembly.

مرجع VBA فيه المميزات التالية:

يوفر أمثلة تعليمات برمجية لمعظم الأعضاء .

مرجع VBA فيه العيوب التالية:

يوفر أمثلة بناء الجملة و التعليمة البرمجية لـ VBA فقط. لاستخدم أمثلة التعليمة البرمجية في مشروع Office، يجب أن تقوم بترجمة تعليمة VBA البرمجية إلى Visual Basic أو Visual C#‎.

أنواع إضافية في تجميع التوافق الأساسي

تجميع التوافق الأساسي يحتوي على العديد من الأنواع غير المتوفرة لـ VBA. هذه الأنواع الإضافية تساعد على ترجمة الكائنات في نموذج كائن يستند إلى COM خاص بـ Outlook إلى تعليمات برمجية مدارة ، غير معدة للاستعمال بشكل مباشر في التعليمات البرمجية الخاصة بك.

لمزيد من المعلومات، راجع بنية PIA Outlook.