共用方式為


介面 (C++/CX)

雖然 ref 類別最多可以繼承自一個具象基底類別,但它可以實作任意數目的介面類別。 介面類別 (或介面結構) 本身可以繼承 (或要求) 多個介面類別、可以多載其成員函式,也可以具有類型參數。

特性

介面具有這些特性:

  • 您必須在命名空間中宣告介面類別 (或結構),且此介面類別 (或結構) 可以具有公用或私用存取範圍。 只有公用介面會發出至中繼資料。

  • 介面的成員可以包括屬性、方法和事件。

  • 所有介面成員都是隱含公用及虛擬的成員。

  • 不允許使用欄位和靜態成員。

  • 做為屬性、方法參數或傳回值的型別只能 Windows 執行階段 型別;這包括基本型別和列舉類別類型。

宣告和用法

下列範例顯示如何宣告介面。 請注意,介面可以宣告為類別或結構類型。

namespace InterfacesTest
{
    public enum class PlayState {Playing, Paused, Stopped, Forward, Reverse};

    public ref struct MediaPlayerEventArgs sealed
    {
        property PlayState oldState;
        property PlayState newState;
    };

    public delegate void OnStateChanged(Platform::Object^ sender, MediaPlayerEventArgs^ a);
    public interface class IMediaPlayer // or public interface struct IMediaPlayer 
    {
        event OnStateChanged^ StateChanged;
        property Platform::String^ CurrentTitle;
        property PlayState CurrentState;
        void Play();
        void Pause();
        void Stop();
        void Back(float speed);
        void Forward(float speed);
    };
}

為了實作介面,由 ref 類別或 ref 結構宣告並實作虛擬方法和屬性。 此介面和實作的 ref 類別必須使用相同的方法參數名稱,如下列範例所示:

public ref class MyMediaPlayer sealed : public IMediaPlayer
{
public:
    //IMediaPlayer
    virtual event OnStateChanged^ StateChanged;
    virtual property Platform::String^ CurrentTitle;
    virtual property PlayState CurrentState;
    virtual void Play()
    {
        // ...
        auto args = ref new MediaPlayerEventArgs(); 
        args->newState = PlayState::Playing;
        args->oldState = PlayState::Stopped;
        StateChanged(this, args);
    }
    virtual void Pause(){/*...*/}
    virtual void Stop(){/*...*/}
    virtual void Forward(float speed){/*...*/}
    virtual void Back(float speed){/*...*/}
private:
    //...
};

介面繼承階層架構

介面可以繼承一或多個介面。 但是,不同於 ref 類別或結構,介面不會宣告繼承的介面成員。 如果介面 B 繼承自介面 A,而 ref 類別 C 繼承自 B,則 C 必須同時實作 A 和 B。下一個範例將提供示範。

public interface struct A { void DoSomething(); };
public interface struct B : A { void DoSomethingMore();};

public ref struct C sealed : B
{
    virtual void DoSomething(){}
    virtual void DoSomethingMore(){}
};


實作介面屬性和事件

如上述範例所示,您可以使用 trivial 虛擬屬性來實作介面屬性。 您也可以在實作類別中提供自訂 getter 和 setter。 Getter 和 setter 都必須是公用的介面屬性。

//Alternate implementation in MediaPlayer class of IMediaPlayer::CurrentTitle
virtual property Platform::String^ CurrentTitle
{
    Platform::String^ get() {return "Now playing: " + _title;}
    void set(Platform::String^ t) {_title = t; }
}

如果介面宣告 get-only 或 set-only 屬性,則實作的類別應該明確地提供 getter 或 setter。

public interface class IMediaPlayer
{
    //...
    property Platform::String^ CurrentTitle
    {
        Platform::String^ get();           
    }
};

public ref class MyMediaPlayer3 sealed : public IMediaPlayer
{
public:
    //...
    virtual property Platform::String^ CurrentTitle
    {
        Platform::String^ get() {return "Now playing: " + _title;}
    }
private:
    Platform::String^ _title;
};

您也可以在實作的類別中,實作事件的自訂 add 和 remove 方法。

明確介面實作

當 ref 類別實作多個介面,且這些介面的方法具有與編譯器相同的名稱和簽章時,您可以使用下列語法明確表示實作類別方法的介面方法。

public interface class IArtist
{     
    Platform::String^ Draw();
};

public interface class ICowboy
{
    Platform::String^ Draw();
};

public ref class MyClass sealed : public IArtist, ICowboy
{
public:     
    MyClass(){}     
    virtual  Platform::String^ ArtistDraw() = IArtist::Draw {return L"Artist";}
    virtual  Platform::String^ CowboyDraw() = ICowboy::Draw {return L"Cowboy";}
};

泛型介面

在 C++/CX 中generic,關鍵詞用來表示 Windows 執行階段 參數化類型。 參數化類型會在中繼資料中發出,以供使用支援類型參數之任何語言撰寫的程式碼使用。 Windows 執行階段 會定義一些泛型介面,例如 Windows::Foundation::Collections::IVector<T>,但它不支援在 C++/CX 中建立公用使用者定義泛型介面。 不過,您可以建立私用泛型介面。

以下是如何使用 Windows 執行階段 類型來撰寫泛型介面:

  • 您不可以將元件中使用者定義的泛型 interface class 發出至其 Windows 中繼資料檔案,因此該類別不可以具有公用存取範圍,且其他 .winmd 檔案中的用戶端程式碼無法實作該類別。 此類別可由相同元件中的非公用 ref 類別實作。 公用 ref 類別可以包含泛型介面類型做為私用成員。

    下列程式碼片段示範如何宣告泛型 interface class ,然後在私用 ref 類別中實作,並使用 ref 類別做為公用 ref 類別的私用成員。

    public ref class MediaFile sealed {};
    
    generic <typename T>
    private interface class  IFileCollection
    {
        property Windows::Foundation::Collections::IVector<T>^ Files;
        Platform::String^  GetFileInfoAsString(T file);
    };
    
    private ref class MediaFileCollection : IFileCollection<MediaFile^>
    {
    public:
        virtual property Windows::Foundation::Collections::IVector<MediaFile^>^ Files;
        virtual Platform::String^  GetFileInfoAsString(MediaFile^ file){return "";}
    };
    
    public interface class ILibraryClient
    {
        bool FindTitle(Platform::String^ title);       
        //...
    };
    
    public ref class MediaPlayer sealed : public IMediaPlayer, public ILibraryClient
    {
    public:
        //IMediaPlayer
        virtual event OnStateChanged^ StateChanged;
        virtual property Platform::String^ CurrentTitle;
        virtual property PlayState CurrentState;
        virtual void Play()
        {
            auto args = ref new MediaPlayerEventArgs(); 
            args->newState = PlayState::Playing;
            args->oldState = PlayState::Stopped;
            StateChanged(this, args);
        }
        virtual void Pause(){/*...*/}
        virtual void Stop(){/*...*/}
        virtual void Forward(float speed){/*...*/}
        virtual void Back(float speed){/*...*/}
    
        //ILibraryClient
        virtual bool FindTitle(Platform::String^ title){/*...*/ return true;}
    
    private:
        MediaFileCollection^ fileCollection;
    
    };
    
  • 泛型介面必須遵循規範存取範圍、成員、「 需要 」(Requires) 關聯性、基底類別等的標準介面規則。

  • 泛型介面可以接受一或多個前面有 typenameclass的泛型類型參數。 不支援非類型參數。

  • 類型參數可以是任何 Windows 執行階段 類型。 也就是說,類型參數可以是參考類型、實值類型、介面類別、委派、基礎類型或公用列舉類別。

  • 封閉式泛型介面 」(Closed Generic Interface) 是繼承自泛型介面,並指定所有類型參數之具象類型引數的介面。 只要可以使用非泛型私用介面的地方,都能使用此介面。

  • 開放式泛型介面 」(Open Generic Interface) 是其中有一或多個類型參數類型,尚未提供具象類型的介面。 只要可以使用類型的地方,都能使用此類型,包括做為另一個泛型介面的類型引數。

  • 您只能參數化整個介面,不能參數化個別的方法。

  • 類型參數不可受到條件約束。

  • 封閉式泛型介面具有隱含產生的 UUID。 使用者無法指定 UUID。

  • 在介面中,對目前介面的所有參考 (包括在方法參數、傳回值或屬性中) 都假設為參考目前的具現化。 例如,IMyIntf 表示 IMyIntf<T >

  • 當方法參數的類型是類型參數時,該參數或變數的宣告會使用類型參數的名稱,而不需要任何指標、原生參考或句柄宣告子。 換句話說,您不需撰寫 "T^"。

  • 樣板化 ref 類別必須是私用類別。 它們可以實作泛型介面,並將範本參數 T 傳遞至泛型自變數 T。樣板化 ref 類別的每個具現化本身都是 ref 類別。

另請參閱

類型系統
C++/CX 語言參考
命名空間參考