Freigeben über


Gewusst wie: Ruft ab Eigenschaftenfenster-Feld-Beschreibungen

Am unteren Rand des Fensters wird ein Bereich Beschreibung Eigenschaften Informationen zum ausgewählten Eigenschaftenfeld angezeigt. Diese Funktion ist standardmäßig aktiviert. Wenn Sie mit der rechten Maustaste auf das Textfeld, und klicken Sie auf das Fenster EigenschaftenBeschreibungausblenden möchten. Auf diese Weise wird auch das Häkchen neben dem Namen im Beschreibung Menübereich. Sie können das Feld erneut anzeigen, indem Sie die gleichen Schritte ausführen, um Beschreibung auf Zurück.

Die Informationen im Textfeld stammen aus ITypeInfo. Jede Methode, eine Schnittstelle Co-Klasse, kann ein nicht gefunden helpstring-Attribut in der Typbibliothek usw.) aufweisen. Das Fenster Eigenschaften die Zeichenfolge vom GetDocumentationab.

Um Hilfe die lokalisierte Zeichenfolgen angeben

  1. Fügen Sie das Attribut der helpstringdll-Anweisung Bibliothek in der Typbibliothek hinzu (typelib).

    Hinweis

    Dieser Schritt ist optional, wenn die Typbibliothek in eine Objektbibliothek (.olb) - Datei basiert.

  2. Geben Sie helpstringcontext-Attribute für die Zeichenfolgen dargestellt. Sie können auch Attribute helpstring angeben.

    Diese Attribute sind von den helpfilehelpcontext und andere Attribute in der eigentlichen CHM-Datei Hilfethemen enthalten sind.

Um die für den markierten Namen der anzuzeigenden Beschreibungsinformationen abzurufen, ruft das Eigenschaften das Fenster GetDocumentation2 die für die Eigenschaft aktiviert ist, und gibt an lcid das gewünschte Attribut für die Ausgabezeichenfolge angezeigt. Intern wird ITypeInfo2 die DLL-Datei, die im helpstringdll-Attribut angegeben ist, und ruft diese auf DLLGetDocumentation DLL-Datei mit dem angegebenen Kontext und dem lcid-Attribut an.

Die Signatur und die Implementierung von DLLGetDocumentation sind:

STDAPI DLLGetDocumentation
(
   ITypeLib * /* ptlib */,
   ITypeInfo * /* ptinfo */,
   LCID /* lcid */,
   DWORD dwCtx,
   BSTR * pbstrHelpString
);

Die DLLGetDocumentation-Funktion muss ein Export sein, der in der DEF-Datei für die DLL definiert ist.

Intern wird eine .olb-Datei erstellt, die tatsächlich eine DLL ist. Diese DLL enthält eine Ressource, die Datei der Typbibliothek (.tlb) und eine exportierte Funktion, DLLGetDocumentation.

Im Fall .olb-Dateien ist das helpstringdll-Attribut optional, da es die gleiche Datei ist, die die TLB-Datei selbst enthält.

Zum Abrufen von Zeichenfolgen in Beschreibungen Bereich zu veranschaulichen, das den Mindestwert ist daher müssen Sie das helpstring-Attribut in der Typbibliothek angegeben wird. Wenn Sie diese Zeichenfolgen lokalisiert werden soll, müssen Sie das Attribut helpstringdll (optional) und (erforderliche) helpstringcontext-Attribut angeben und DLLGetDocumentationimplementieren.

Es gibt keine zusätzlichen Schnittstellen, die implementiert werden müssen, wenn diese lokalisierte Informationen über helpstringcontext-Attribut und DLLGetDocumentationder idls abrufen.

Eine andere Möglichkeit von erhalten Der lokalisierte Titel und die lokalisierte Beschreibung der Eigenschaft entspricht, indem Sie GetLocalizedPropertyInfoimplementiert. Weitere Informationen hinsichtlich der Implementierung dieser Methode finden Sie unter Eigenschaftenfenster-Felder und Schnittstellen.

Siehe auch

Referenz

IVsPerPropertyBrowsing

helpstringdll

helpstring

helpstringcontext

helpcontext

helpfile

lcid

Konzepte

Eigenschaftenfenster-Felder und Schnittstellen

Weitere Ressourcen

Eigenschaftenfenster und Eigenschaftenseiten