属性プログラミングの FAQ

HRESULT は単純なデータ型であり、一般的に属性と ATL によって戻り値としてよく使用されます。 次の表で各種の値について説明します。 ヘッダー ファイル winerror.h には、より多くの値が含まれています。

ほとんどの場合、 属性に 1 つのパラメーターがあるときに、そのパラメーターに名前が付けられます。 この名前は、コードに 属性を挿入するときは必要ありません。 たとえば、 aggregatable 属性を次のように使用するとします

[coclass, aggregatable(value=allowed)]
class CMyClass
{
// The class declaration
};

これは、次の場合とまったく同じです。

[coclass, aggregatable(allowed)]
class CMyClass
{
// The class declaration
};

ただし、次の属性には、名前のない 1 つのパラメーターがあります。

属性ブロック内で単一行と複数行の両方のコメントを使用できます。 ただし、パラメーターを属性に保持するかっこ内では、どちらのスタイルのコメントも使用できません。

次は許可されます。

[ coclass, progid("MyClass.CMyClass.1"), /* Multiple-line
                                       comment */
   threading("both") // Single-line comment
]

次は許可されません。

[ coclass, progid("MyClass.CMyClass.1" /* Multiple-line comment */ ), threading("both" // Single-line comment)
]

属性付きクラスと属性なしのクラスの両方を、他のクラスから継承できます (他のクラス自体は、属性付きまたは属性なしの場合があります)。 属性付きクラスから派生した結果は、属性プロバイダーがコードを変換した後のクラスからの派生と同じです。 属性は、C++ の継承を介して派生クラスに伝達されません。 属性プロバイダーは、その属性の近傍のコードのみを変換します。

.idl ファイルを含む属性なしの ATL プロジェクトが存在する場合があり、属性付きオブジェクトの追加を開始することが必要な場合があります。 この場合は、クラス追加ウィザードを使用して コードを指定します。

ATL 属性付きプロジェクトで使用する .idl ファイルがある場合があります。 この場合は、importidl 属性を使用し、.idl ファイルを .h ファイルにコンパイルし (プロジェクトの [プロパティ ページ] ダイアログ ボックスの MIDL プロパティ ページを参照)、その後プロジェクトに .h ファイルを含めます。

一部の属性では、プロジェクトにコードが挿入されます。 挿入されたコードは、/Fx コンパイラ オプションを使用して確認できます。 挿入されたファイルからコードをコピーし、ソース コードに貼り付けることも可能です。 これにより、 属性の動作を変更できます。 ただし、コードの他の部分も変更することが必要な場合もあります。

次の例は、挿入されたコードをソース コード ファイルにコピーした結果です。

// attr_injected.cpp
// compile with: comsupp.lib
#define _ATL_ATTRIBUTES 1
#include <atlbase.h>
#include <atlcom.h>

[ module(name="MyLibrary") ];

// ITestTest
[
   object, uuid("DADECE00-0FD2-46F1-BFD3-6A0579CA1BC4"), dual, helpstring("ITestTest Interface"), pointer_default(unique)
]

__interface ITestTest : IDispatch {
   [id(1), helpstring("method DoTest")]
   HRESULT DoTest([in] BSTR str);
};

// _ITestTestEvents
[
   uuid("12753B9F-DEF4-49b0-9D52-A79C371F2909"), dispinterface, helpstring("_ITestTestEvents Interface")
]

__interface _ITestTestEvents {
   [id(1), helpstring("method BeforeChange")] HRESULT BeforeChange([in] BSTR str, [in,out] VARIANT_BOOL* bCancel);
};

// CTestTest
[
   coclass, threading(apartment), vi_progid("TestATL1.TestTest"), progid("TestATL1.TestTest.1"), version(1.0), uuid("D9632007-14FA-4679-9E1C-28C9A949E784"), // this line would be commented out from original file
   // event_source("com"), // this line would be added to support injected code
   source(_ITestTestEvents), helpstring("TestTest Class")
]

class ATL_NO_VTABLE CTestTest : public ITestTest,
// the following base classes support added injected code
public IConnectionPointContainerImpl<CTestTest>,
public IConnectionPointImpl<CTestTest, &__uuidof(::_ITestTestEvents), CComDynamicUnkArray>
{
public:
   CTestTest() {
   }
   // this line would be commented out from original file
   // __event __interface _ITestTestEvents;
   DECLARE_PROTECT_FINAL_CONSTRUCT()
   HRESULT FinalConstruct() {
      return S_OK;
   }

void FinalRelease() {}

public:
   CComBSTR m_value;
   STDMETHOD(DoTest)(BSTR str) {
      VARIANT_BOOL bCancel = FALSE;
      BeforeChange(str,&bCancel);
      if (bCancel) {
          return Error("Error : Someone don't want us to change the value");
      }

   m_value =str;
   return S_OK;
    }
// the following was copied in from the injected code.
HRESULT BeforeChange(::BSTR i1,::VARIANT_BOOL* i2) {
   HRESULT hr = S_OK;
   IConnectionPointImpl<CTestTest, &__uuidof(_ITestTestEvents), CComDynamicUnkArray>* p = this;
   VARIANT rgvars[2];
   Lock();
   IUnknown** pp = p->m_vec.begin();
   Unlock();
   while (pp < p->m_vec.end()) {
      if (*pp != NULL) {
         IDispatch* pDispatch = (IDispatch*) *pp;
         ::VariantInit(&rgvars[1]);
         rgvars[1].vt = VT_BSTR;
         V_BSTR(&rgvars[1])= (BSTR) i1;
         ::VariantInit(&rgvars[0]);
         rgvars[0].vt = (VT_BOOL | VT_BYREF);
         V_BOOLREF(&rgvars[0])= (VARIANT_BOOL*) i2;
         DISPPARAMS disp = { rgvars, NULL, 2, 0 };
         VARIANT ret_val;
         hr = __ComInvokeEventHandler(pDispatch, 1, 1, &disp, &ret_val);
         if (FAILED(hr))
            break;
      }
      pp++;
   }
   return hr;
}

BEGIN_CONNECTION_POINT_MAP(CTestTest)
CONNECTION_POINT_ENTRY(__uuidof(::_ITestTestEvents))
END_CONNECTION_POINT_MAP()
// end added code section

// _ITestCtrlEvents Methods
public:
};

int main() {}

属性付きインターフェイスの前方宣言を行う場合は、実際のインターフェイス宣言に適用する前方宣言と同じ属性を適用する必要があります。 また、前方宣言に export 属性を適用する必要があります。

いいえ。属性を使用するクラスから派生したクラスで属性を使用することは、サポートされていません。

関連項目

COM および .NET の C++ の属性