Compartilhar via

PROPSHEETHEADER

  • Artigo

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa estrutura define o quadro e páginas de um folha de propriedades.

Syntax

typedef struct _PROPSHEETHEADER { 
  DWORD dwSize; 
  DWORD dwFlags; 
  HWND hwndParent; 
  HINSTANCE hInstance; 
  union {
    HICON hIcon; 
    LPCWSTR pszIcon; 
  };
  LPCWSTR pszCaption; 
  UINT nPages; 
  union {
    UINT nStartPage; 
    LPCWSTR pStartPage; 
  };
  union {
    LPCPROPSHEETPAGE ppsp; 
    HPROPSHEETPAGE FAR* phpage; 
  };
  PFNPROPSHEETCALLBACK pfnCallback;
} PROPSHEETHEADER, FAR* LPPROPSHEETHEADER;
typedef const PROPSHEETHEADER FAR* LPCPROPSHEETHEADER;

Os membros

  • dwSize
    Especifica o tamanho, em bytes, dessa estrutura.

  • dwFlags
    Especifica um máscara de bits de sinalizadores que indicam quais opções para usar ao criar a página folha de propriedades. Ele pode ser uma combinação do seguinte valores.

    Valor Descrição

    PSH_DEFAULT

    Usa o significado usar como padrão para todos os membros estrutura.

    PSH_HASHELP

    Exibe a folha de propriedades Ajuda botão. O Ajuda botão é habilitado somente quando o sinalizador PSP_HASHELP está definida na PROPSHEETPAGE estrutura para o página ativa. Se qualquer uma das páginas inicial folha de propriedades definir o sinalizador PSP_HASHELP, o Ajuda botão é automaticamente exibida regardless of o sinalizador PSH_HASHELP. No entanto, PSH_HASHELP é útil quando nenhuma das páginas iniciais definir PSP_HASHELP, mas talvez páginas adicionadas posteriormente.

    PSH_HEADER

    Indica que um bitmap cabeçalho será usado. Se esse valor não inclui PSH_USEHBMHEADER, o bitmap cabeçalho é obtida do pszbmHeader. Se esse valor inclui PSH_USEHBMHEADER, o bitmap cabeçalho é obtida do hbmHeader. Este sinalizador será ignorado se PSH_WIZARD97 não for incluído.

    PSH_MAXIMIZE

    Faz com que o Gerenciador diálogo para tornar a folha de propriedades um total-janela Tela. Esse estilo não é compatível com PSH_WIZARD.

    PSH_MODELESS

    Faz com que o PropertySheet função para criar o folha de propriedades como uma sem janela restrita diálogo instead of como um restrito diálogo. Quando esse sinalizador for definido, PropertySheet retorna imediatamente após a criação de diálogo e a valor de retorno de PropertySheet é o manipulador de janela para o diálogo folha de propriedades.

    PSH_NOAPPLYNOW

    Remove o Aplicar agora botão.

    PSH_PROPSHEETPAGE

    Usa ppsp e ignora phpage Ao criar as páginas para o folha de propriedades.

    PSH_PROPTITLE

    Exibe o seqüência de caracteres "Propriedades de", seguido pela seqüência de caracteres especificado por pszCaption, no barra de título da folha de propriedades.

    PSH_RTLREADING

    Inverte a direção na qual pszCaption é exibida. Exibir janelas normal todo o texto, incluindo pszCaption, da esquerda - para - direito (EPD). Para os idiomas como árabe ou hebraico que ler right-to-Left (RTL), uma janela pode ser espelhada e todo o texto será exibido RTL. Se PSH_RTLREADING for definido, pszCaption será, em vez disso, ler RTL em um janela pai normal e EPD em um janela pai espelhado.

    PSH_STRETCHWATERMARK

    Expande o bitmap para ajustar o segundo plano de folha de propriedades instead of lado a lado o bitmap marca d'água e / ou cabeçalho. Este sinalizador será ignorado se PSH_WIZARD97 e PSH_WATERMARK ou PSH_HEADER não estão incluídos.

    PSH_USECALLBACK

    Chama a função especificada pelo pfnCallback Ao inicializar o folha de propriedades definido por essa estrutura.

    PSH_USEHBMHEADER

    Obtém o bitmap do cabeçalho hbmHeader em vez de pszbmHeader. Este sinalizador será ignorado se PSH_WIZARD97 e PSH_HEADER não estão incluídos.

    PSH_USEHBMWATERMARK

    Obtém o bitmap marca d'água de hbmWatermark em vez de pszbmWatermark. Este sinalizador será ignorado se PSH_WIZARD97 e PSH_WATERMARK não estão incluídos.

    PSH_USEHICON

    Não suportado.

    PSH_USEHPLWATERMARK

    Obtém o HPALETTE para desenhar o bitmap marca d'água e / ou bitmap cabeçalho de hplWatermark Em vez de usar a paleta usar como padrão. Este sinalizador será ignorado se PSH_WIZARD97 e PSH_WATERMARK ou PSH_HEADER não estão incluídos.

    PSH_USEICONID

    Não suportado.

    PSH_USEPAGELANG

    A linguagem para o folha de propriedades será tirada do recurso da página de primeiro.

    PSH_USEPSTARTPAGE

    Usa pStartPage e ignora nStartPage Ao exibir a página inicial da folha de propriedades.

    PSH_WATERMARK

    Especifica que um bitmap marca d'água irá ser usado. Se esse valor não inclui PSH_USEHBMWATERMARK, o bitmap marca d'água é obtida do pszbmWatermark. Se esse valor inclui PSH_USEHBMWATERMARK, o bitmap cabeçalho é obtida do hbmWatermark. Este sinalizador será ignorado se PSH_WIZARD97 não for incluído.

    PSH_WIZARD

    Cria um folha de propriedades assistente.

    PSH_WIZARD97

    Cria um folha de propriedades assistente que permite que um cabeçalho e / ou bitmap marca d'água a serem exibidos no segundo plano. Este e todos os 97 assistente-associado sinalizadores não são implementados no momento.

    PSH_WIZARDCONTEXTHELP

    Adiciona um menu sistema folha de propriedades o assistente. Este sinalizador será ignorado se não for incluído PSH_WIZARD ou PSH_WIZARD97.

    PSH_WIZARDHASFINISH

    Sempre exibe a Término botão Sobre o assistente. Este sinalizador será ignorado se não for incluído PSH_WIZARD ou PSH_WIZARD97.
  • hwndParent
    Identificador para janela proprietária do folha de propriedades.
  • hInstance
    Identificador para a instância a partir da qual carregar o recurso seqüência de caracteres ícone ou título. Se pszIcon Ou pszCaption Identifica um recurso para carregar, esse membro deve ser especificado.
  • hIcon
    Ignorado. Deve ser NULL.
  • pszIcon
    Ignorado. Deve ser NULL.
  • pszCaption
    Ponteiro para o seqüência de caracteres NULL-Terminated que contém o título da caixa de diálogo folha de propriedades. Esse membro pode especificar ao identificador de um recurso seqüência de caracteres ou o endereço de uma seqüência de caracteres que especifica o título. Se dwFlags Inclui o seqüência de caracteres, PSH_PROPTITLE "Propriedades para" é inserido no início do título.
  • nPages
    Número de elementos de phpage matriz.
  • nStartPage
    Índice baseado em zero da página inicial que aparece quando a caixa diálogo folha de propriedades é criada.
  • pStartPage
    Ponteiro para o nome da página inicial que aparece quando a caixa diálogo folha de propriedades é criada. Esse membro pode especificar ao identificador de um recurso seqüência de caracteres ou o endereço de uma seqüência de caracteres que especifica o nome.
  • ppsp
    Ponteiro para uma matriz de PROPSHEETPAGE estruturas que definem as páginas na folha de propriedades. Se dwFlags Não inclua PSH_PROPSHEETPAGE, esse membro será ignorado.
  • phpage
    Ponteiro para uma matriz de identificadores para as páginas folha de propriedades. Cada identificador deve ter sido criado por um chamar anterior para o CreatePropertySheetPage função. Se dwFlags Inclui PSH_PROPSHEETPAGE, esse membro será ignorado.
  • pfnCallback
    Ponteiro para uma função callback Application-defined que é chamado quando o folha de propriedades é inicializado. Para obter mais informações sobre o função callback, consulte a descrição das PropSheetProc função. Se dwFlags Não inclua PSH_USECALLBACK, esse membro será ignorado.
  • hbmWatermark
    Identificador para o bitmap marca d'água. Se dwFlags Não inclua PSH_USEHBMWATERMARK, esse membro será ignorado.
  • pszbmWatermark
    Ponteiro para um recurso bitmap para usar como a marca d'água. Esse membro pode especificar ao identificador de recurso de bitmap ou o endereço de seqüência de caracteres que especifica o nome do recurso de bitmap. Se dwFlags Inclui PSH_USEHBMWATERMARK, esse membro será ignorado.
  • hplWatermark
    HPALETTE Usado para desenhar o bitmap marca d'água e / ou bitmap cabeçalho. Se dwFlags Não inclua PSH_USEHPLWATERMARK, esse membro será ignorado.
  • hbmHeader
    Identificador para o bitmap cabeçalho. Se dwFlags Não inclua PSH_USEHBMHEADER, esse membro será ignorado.
  • pszbmHeader
    Ponteiro para um recurso bitmap para usar como o cabeçalho. Esse membro pode especificar ao identificador de recurso de bitmap ou o endereço de seqüência de caracteres que especifica o nome do recurso de bitmap. Se dwFlags Inclui PSH_USEHBMHEADER, esse membro será ignorado.

Requirements

Header prsht.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CreatePropertySheetPage
PropertySheet
PropSheetProc
PROPSHEETPAGE