Struttura PROPPAGEINFO (ocidl.h)

Articolo
03/05/2024

Contiene i parametri utilizzati per descrivere una pagina delle proprietà in un frame di proprietà. Una pagina delle proprietà riempie una struttura fornita dal chiamante nel metodo IPropertyPage::GetPageInfo .

Sintassi

typedef struct tagPROPPAGEINFO {
  ULONG    cb;
  LPOLESTR pszTitle;
  SIZE     size;
  LPOLESTR pszDocString;
  LPOLESTR pszHelpFile;
  DWORD    dwHelpContext;
} PROPPAGEINFO, *LPPROPPAGEINFO;

Members

cb

Dimensioni della struttura, in byte.

pszTitle

Puntatore a un OLESTR contenente la stringa visualizzata nella scheda per questa pagina. La stringa deve essere allocata con CoTaskMemAlloc. Il chiamante di IPropertyPage::GetPageInfo è responsabile della liberazione della memoria con CoTaskMemFree.

size

Dimensioni obbligatorie della finestra di dialogo della pagina, in pixel.

pszDocString

Puntatore a una stringa di testo che descrive la pagina, che può essere visualizzata nella finestra di dialogo della finestra delle proprietà (l'implementazione del frame corrente non usa questo campo). Il testo deve essere allocato con CoTaskMemAlloc. Il chiamante di IPropertyPage::GetPageInfo è responsabile della liberazione della memoria con CoTaskMemFree.

pszHelpFile

Puntatore a un OLESTR contenente il nome semplice del file della Guida che descrive questa pagina delle proprietà utilizzata anziché implementare IPropertyPage::Help. Quando l'utente preme La Guida, il metodo della Guida viene in genere chiamato. Se il metodo ha esito negativo, il frame aprirà il sistema della Guida con questo file della Guida (preceduto dal valore della chiave HelpDir nelle voci del Registro di sistema della pagina delle proprietà nel relativo CLSID) e indicherà al sistema della Guida di visualizzare il contesto descritto dal campo dwHelpContext . Il percorso deve essere allocato con CoTaskMemAlloc. Il chiamante di IPropertyPage::GetPageInfo è responsabile della liberazione della memoria con CoTaskMemFree.

dwHelpContext

Identificatore di contesto per l'argomento della Guida all'interno di pszHelpFile che descrive questa pagina.

Commenti

I membri pszTitle, pszDocString e pszHelpFile specificati in questa struttura devono contenere testo sensibile alle impostazioni locali ottenute tramite IPropertyPageSite::GetLocaleID.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ocidl.h

Vedi anche

IPropertyPage::GetPageInfo

IPropertyPageSite::GetLocaleID

OLESTR

Condividi tramite