Diretiva INF ProfileItems

Uma diretiva ProfileItems é usada numa secção INF DDInstall para listar uma ou mais secções de itens de perfil que contenham itens ou grupos a serem adicionados ou removidos do menu Iniciar.

[DDInstall] 
 
ProfileItems=profile-items-section[,profile-items-section]...
...

Cada secção nomeada referenciada por uma diretiva ProfileItems tem a seguinte forma:

[profile-items-section]
 
Name=link-name[,name-attributes]
CmdLine=dirid,[subdir],filename
[SubDir=path]
[WorkingDir=wd-dirid,wd-subdir]
[IconPath=icon-dirid,[icon-subdir],icon-filename]
[IconIndex=index-value]
[HotKey=hotkey-value]
[Infotip=info-tip]
[DisplayResource="ResDllPath\ResDll",ResID]

Esta diretiva é suportada no Windows XP e versões posteriores do Windows.

Entradas

Nome=nome-nome[,nome-atributos]
O nome do link especifica o nome do link para o item do menu ou grupo, sem a extensão .lnk . Este valor pode ser uma string ou um %strkey% token definido numa secção Strings do ficheiro INF. Se uma entrada DisplayResource não for especificada, o nome do link é também a cadeia de visualização.

O valor opcional nome-atributos especifica uma ou mais bandeiras que afetam a operação no item do menu. Este valor é expresso como uma máscara de bits OR de valores de flag definidos pelo sistema. As possíveis bandeiras incluem as seguintes:

0x00000001 (FLG_PROFITEM_CURRENTUSER)
Orienta o Windows a criar ou eliminar um elemento do menu Iniciar no perfil do utilizador atual. Se este flag não for especificado, o Windows processa o item para todos os utilizadores.

0x00000002 (FLG_PROFITEM_DELETE)
Indica ao Windows para eliminar o item do menu. Se este flag não for especificado, o item é criado.

0x00000004 (FLG_PROFITEM_GROUP)
Orienta o Windows a criar ou eliminar um grupo do menu Iniciar em Iniciar\Programas. Se este flag não for especificado, o Windows cria ou elimina um item de menu, não um grupo de menus.

Se não for especificado nenhum sinal, o Windows cria um elemento de menu para todos os utilizadores.

CmdLine=dirid,[subdir],nome do ficheiro
O dirid especifica um valor que identifica o diretório onde reside o programa de comandos. Por exemplo, um dirid de 11 indica o diretório do sistema. Os possíveis valores de dirid estão listados na descrição do valor de dirid na secção DestinationDirs .

Se houver uma cadeia de subdir , o programa de comandos está num subdiretório do diretório referenciado pelo dirid. O subdiretório especifica o subdiretório. Se não for especificado nenhum subdir , o programa está no diretório referenciado pelo dirid.

O nome do ficheiro especifica o nome do programa associado ao item do menu.

SubDir=path
Esta entrada opcional especifica um subdiretório (submenu) sob Iniciar\Programas onde reside o item do menu. Se esta entrada for omitida, o caminho passa por defeito para Start\Programs.

Por exemplo, se a secção de itens do perfil tiver a entrada "Subdir=Accessories\Games", então o elemento do menu está a ser criado ou eliminado no submenu Start\Programs\Accessories\Games.

WorkingDir=wd-dirid[,wd-subdir]
Esta entrada opcional especifica um diretório funcional para o programa de comandos. Se esta entrada for omitida, o diretório de trabalho passa por defeito ao diretório onde reside o programa de comandos.

O valor wd-dirid identifica o diretório de trabalho. Para listas de possíveis valores de dirid , veja Usar Dirids.

A cadeia wd-subdir , se presente, especifica que um subdiretório de wd-dirid é o diretório de trabalho. Use este parâmetro para especificar um diretório que não tenha um dirid definido pelo sistema. Se este parâmetro for omitido, o valor wd-dirid por si só especifica o diretório de trabalho.

IconPath=icon-dirid,[icon-subdir],icon-nome do ficheiro
Esta entrada opcional especifica a localização de um ficheiro que contém um ícone para o item do menu.

A string icon-dirid identifica o diretório da DLL que contém o ícone. Para listas de possíveis valores de dirid , veja Usar Dirids.

O valor do icon-subdir , se presente, indica que a DLL está num subdiretório do icon-dirid. O valor do subdiretor ícone especifica o subdiretório.

O valor do nome do ficheiro ícone especifica a DLL que contém o ícone.

Se esta entrada for omitida, o Windows procura um ícone no ficheiro especificado na entrada do CmdLine.

IconIndex=valor-índice
Esta entrada opcional especifica qual ícone numa DLL deve ser usado para o item do menu. Para informações sobre como indexar os ícones numa DLL, consulte a documentação do Microsoft Windows SDK.

Se for especificada uma entrada IconPath , o valor do índice é indexado nessa DLL. Caso contrário, este valor indexa-se para o ficheiro especificado na entrada CmdLine .

HotKey=atalho-valor-de-tecla
Esta entrada opcional especifica um acelerador de teclado para o item do menu.

Para mais informações sobre teclas de atalho, consulte a documentação do SDK do Windows.

Infodica=info-dica
Esta entrada opcional especifica uma dica informativa para o item do menu.

Este valor pode ser uma string ou um %strkey% token definido numa secção Strings do ficheiro INF.

O valor da dica de informação também pode ser especificado como "@ResDllPath\ResDll,-ResID", onde ResDllPath e ResDll especificam o caminho e o nome do ficheiro de uma DLL de recurso, e -resID é um valor negativo que representa um ID de recurso.

Use este formato para suportar a Interface Multilíngue do Windows (MUI). Um exemplo é o seguinte:

InfoTip = "@%11%\shell32.dll,-22531"

DisplayResource="ResDllPath\ResDll",ResID
Esta entrada opcional especifica um recurso de cadeia que identifica uma cadeia localizável, a ser usada no menu Iniciar como nome de exibição para atalho ou grupo.

ResDllPath e ResDll especificam o caminho e o nome do ficheiro de uma DLL de recurso, e resID é um valor positivo que representa um ID de recurso. Um exemplo é o seguinte:

DisplayResource="%11%\shell32.dll",22019

Use esta entrada para suportar a Interface Multilíngue do Windows (MUI). Se esta entrada não for utilizada, a cadeia especificada pela entrada do Nome é exibida.

Remarks

Um dado nome de secção de itens de perfil deve ser único dentro do ficheiro INF e deve seguir as regras gerais para definir nomes de secção. Para mais informações sobre estas regras, consulte Regras Gerais de Sintaxe para Ficheiros INF.

Cada secção de itens de perfil contém informações detalhadas para criar ou remover um item ou grupo do menu Iniciar. Para manipular mais do que um item de menu ou grupo a partir de um INF, crie mais do que uma secção de itens de perfil e liste as secções na diretiva Itens de Perfil .

Qualquer um dos parâmetros de string especificados nas entradas de section-items-profile pode ser especificado usando um token% %strkey , conforme descrito em General Syntax Rules for INF Files.

Examples

O seguinte excerto do ficheiro INF mostra como usar a secção de itens de perfil para adicionar a Calculadora ao Menu Iniciar.

[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = %Calc_TIP%
:
:
[Strings]
AccessGroup = "Accessories"
Calc_DESC = "Calculator"
Calc_TIP = "Performs basic arithmetic tasks with an on-screen calculator"

O seguinte excerto do ficheiro INF mostra como instalar o mesmo software usando a entrada DisplayResource para criar itens localizados no menu.

[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="%11%\shell32.dll",22019
:
:
[Strings]
Access_GROUP = "Accessories"
Calc_DESC = "Calculator"

Ver também

DDInstall