Condividi tramite


Procedura: Recuperare le descrizioni del campo della Finestra Proprietà

At the bottom of the Properties window, a description area displays information related to the selected property field. Questa funzionalità è attivata per impostazione predefinita. Se si desidera nascondere il campo della descrizione, fare clic con il pulsante destro del mouse sulla finestra di Proprietà e fare clic descrizione. Questa operazione rimuove anche il segno di spunta accanto al titolo di descrizione nella finestra del menu. È possibile visualizzare nuovamente il campo seguendo la stessa procedura utilizzata per passare descrizione indietro su.

Le informazioni nel campo di descrizione derivano da ITypeInfo. Ogni metodo, l'interfaccia, coclasse e così via, può presentare un attributo non localizzato vengono utilizzati di helpstring nella libreria dei tipi. The Properties window retrieves the string from GetDocumentation.

Per specificare le stringhe localizzate della guida

  1. Aggiungere l'attributo di helpstringdll all'istruzione di libreria nella libreria dei tipi (typelib).

    Nota

    Questo passaggio è facoltativo se la libreria dei tipi è in un file della libreria di oggetti (OLB).

  2. specificare gli attributi di helpstringcontext per le stringhe. È inoltre possibile specificare gli attributi di helpstring .

    Questi attributi sono distinti dagli attributi di helpcontext e di helpfile , contenuti negli argomenti effettivi della Guida del file chm.

To retrieve the description information to be displayed for the highlighted property name, the Properties window calls GetDocumentation2 for the property that is selected, specifying the desired lcid attribute for the output string. Internamente, ITypeInfo2 trova il file DLL specificata nell'attributo di helpstringdll e chiama DLLGetDocumentation sul file DLL con il contesto e l'attributo specificato di lcid .

la firma e l'implementazione di DLLGetDocumentation sono:

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

La funzione di DLLGetDocumentation deve essere un'esportazione definita nel file def della DLL.

Internamente, un file .ocx viene creato un oggetto che rappresenti una DLL. Questa DLL contiene una risorsa, il file della libreria dei tipi (TLB) e una funzione esportata, DLLGetDocumentation.

Nel caso dei file di OLB, l'attributo di helpstringdll è facoltativo perché è lo stesso file che contiene il file stesso .tlb.

Per ottenere le stringhe a essere visualizzati nel riquadro di descrizioni , pertanto, i passaggi essenziali consiste nello specificare l'attributo di helpstring nella libreria dei tipi. Se si desidera che tali stringhe da localizzare, è necessario specificare l'attributo (facoltativo) di helpstringdll e l'attributo (obbligatorio) di helpstringcontext e distribuire DLLGetDocumentation.

Non sono disponibili interfacce aggiuntive che devono essere implementate quando si ottengono informazioni localizzate con l'attributo e DLLGetDocumentationdi helpstringcontext di IDL.

Another way of obtaining the localized name and description of a property is by implementing GetLocalizedPropertyInfo. Per ulteriori informazioni relativi all'implementazione del metodo, vedere Campi e interfacce la Finestra Proprietà.

Vedere anche

Riferimenti

IVsPerPropertyBrowsing

helpstringdll

helpstring

helpstringcontext

helpcontext

helpfile

lcid

Concetti

Campi e interfacce la Finestra Proprietà

Altre risorse

Finestra Proprietà e pagine delle proprietà