CodeEvent-Schnittstelle

Artikel
08/10/2011

Modelliert ein Codeereigniselement.

Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
<GuidAttribute("CE615BD2-8ED5-4F0C-A7B6-4A299D8801FD")> _
Public Interface CodeEvent

[GuidAttribute("CE615BD2-8ED5-4F0C-A7B6-4A299D8801FD")]
public interface CodeEvent

[GuidAttribute(L"CE615BD2-8ED5-4F0C-A7B6-4A299D8801FD")]
public interface class CodeEvent

[<GuidAttribute("CE615BD2-8ED5-4F0C-A7B6-4A299D8801FD")>]
type CodeEvent =  interface end

public interface CodeEvent

Der CodeEvent-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	Access	Ruft einen Wert ab, der bestimmt, wie ein Codeereigniselement durch anderen Code aufgerufen werden kann, oder legt den Wert fest.
	Adder	Ruft die Ereignislistener ab oder legt sie fest.
	Attributes	Ruft eine CodeElements-Auflistung der Attribute für dieses Codeereigniselement ab.
	Children	Ruft eine Auflistung der Objekte ab, die innerhalb von CodeEvent enthalten sind.
	Collection	Ruft eine CodeElements-Auflistung ab.
	Comment	Ruft einen dem Codeereigniselement zugeordneten Headerkommentar ab oder legt diesen fest.
	DocComment	Ruft einen dem Codeereigniselement zugeordneten Dokumentationskommentar ab oder legt diesen fest.
	DTE	Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
	EndPoint	Ruft die Position in der Quelldatei ab, die als Ende des Codeereigniselements markiert ist.
	Extender	Ruft den angeforderten Extender ab, falls er für dieses CodeElement-Objekt verfügbar ist.
	ExtenderCATID	Ruft die ID der Extenderkategorie (CATID) für das Objekt ab.
	ExtenderNames	Ruft eine Liste der für das Objekt verfügbaren Extender ab.
	FullName	Ruft einen vollqualifizierten Namen des angegebenen CodeEvent-Objekts ab.
	InfoLocation	Ruft die Funktionen des Codemodells ab.
	IsCodeType	Ruft ab, ob das CodeEvent ein CodeType ist.
	IsPropertyStyleEvent	Ruft einen Wert ab, der angibt, ob das Ereignis separate Methoden für das Hinzufügen/Entfernen von Ereignissen und das Auslösen von Ausnahmen besitzt.
	IsShared	Ruft den freigegebenen (statischen) Status des Ereignisses ab bzw. legt diesen fest.
	Kind	Ruft den Typ des Codeelements ab.
	Language	Ruft die zum Schreiben des Codes verwendete Programmiersprache ab.
	Name	Ruft den Namen des CodeEvent-Objekts ab oder legt diesen fest.
	OverrideKind	Ruft die Überschreibungsmodifizierer für ein Codeereignis ab oder legt sie fest.
	Parent	Ruft das unmittelbar übergeordnete Objekt des CodeEvent-Objekts ab.
	ProjectItem	Ruft das mit dem CodeEvent-Objekt verknüpfte ProjectItem-Objekt ab.
	Prototype	Ruft eine Zeichenfolge ab, die die Beschreibung eines Codeereigniselements enthält.
	Remover	Ruft die Ereignislistener ab oder legt sie fest.
	StartPoint	Ruft die Position in der Quelldatei ab, die als Anfang des Codeereigniselements markiert ist.
	Thrower	Ruft das CodeFunction-Objekt ab oder legt es fest.
	Type	Ruft den Typ des CodeTypeReference-Objekts ab oder legt ihn fest.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddAttribute	Erstellt ein neues Attributcodekonstrukt und fügt den Code an der korrekten Position ein.
	GetEndPoint	Ruft ein TextPoint-Objekt ab, das das Ende des Codeereigniselements markiert.
	GetStartPoint	Ruft ein TextPoint-Objekt ab, das den Anfang des Codeereigniselements markiert.

Zum Seitenanfang

Hinweise

Dieses Objekt wird vom CodeElement-Objekt abgeleitet.

Tipp

Die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. können nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben. Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie das CodeEvent-Objekt verwendet wird.

So testen Sie diese Eigenschaft

Öffnen Sie das Zielprojekt, und wählen Sie das Codeereigniselement aus, indem Sie den Cursor auf das Ereignisobjekt setzen.
Führen Sie das Add-In aus.

public static void CodeEventExample(EnvDTE80.DTE2 dte)
{
    TextSelection objTextSel;
    EnvDTE80.CodeEvent codeEvent;
    objTextSel = (TextSelection)dte.ActiveDocument.Selection;
    codeEvent = (EnvDTE80.CodeEvent)objTextSel. _
      ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);

    MessageBox.Show("\nAccess property: " +
                    codeEvent.Access, "Testing CodeEvent");
}