Compartilhar via


Como a: Personalizar um controle de representante

Este exemplo mostra o processo básico de criar e implementar um candidato controle delegado a ser usado para a caixa pesquisa exibida no site páginas. O controle especifica texto alternativo e um alternativo arquivo imagem a ser usado para a caixa pesquisa no Web sites onde você ativar o controle.

A alteração o ícone caixa pesquisa e texto alternativo

  1. Criar uma pasta no Diretório \Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES \Program Files\Common Files\Microsoft Shared\web servidor extensions\12\TEMPLATE\FEATURES que é chamado NewSearchBox copiando a pasta \FEATURES\ContentLightup usar como padrão \FEATURES\ContentLightup.

  2. Na pasta de NewSearchBox, aberto o arquivo Feature.xml copiado e gerar um novo GUID para o recurso pela execução Guidgen.exe, localizada em Local_Drive: \ Program Files\Microsoft Visual Studio 8\Common7\Tools. Defina o atributo Scope escopo como Web para que o recurso está ativado no site nível, como segue:

                            <?xml version="1.0" encoding="utf-8"?>
    <Feature 
      Id="9E16894A-998F-4928-97B3-FCB35EAD1C49"
      Title="Standard User Interface Items"
      Description="Provides several standard user interface components and links"
      Version="12.0.0.0"
      Hidden="TRUE"
      DefaultResourceFile="core"
      Scope="Web"
      xmlns="https://schemas.microsoft.com/sharepoint/">
      <ElementManifests>
        <ElementManifest Location="controls\SearchArea.xml" />
      </ElementManifests>
    </Feature>
    
  3. Na subpasta de controles incluída na primeira etapa, modifique o arquivo SearchArea.XML de modo que ele faz referência um alternativo arquivo .ascx. Também especificar texto alternativo e um Sequence valor menor que 100, such as o seguinte:

                            <?xml version="1.0" encoding="utf-8" ?>
    <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
      <Control 
        Id="SmallSearchInputBox" 
        Sequence="99"
        ControlSrc="~/_controltemplates/mySearchArea.ascx">
        <Property name="SearchTextToolTip">Enter text here</Property>
        <Property name="SearchImageToolTip">Go!</Property>
      </Control>
    </Elements>
    
  4. Em \TEMPLATE\CONTROLTEMPLATES, copiar o arquivo SearchArea.ascx e, em seguida, renomear este mySearchArea.ascx arquivo copiado.

  5. On the <img> tag that is located near the end of your copied .ascx file, modify the value of the src attribute to point to an alternate image file. Para testes fins, você pode usar um dos arquivos usar como padrão imagem instalados em \TEMPLATE\IMAGES, como no seguinte exemplo, que substitui gosearch.gif FOLDER.GIF.

                            <INPUT Type=TEXT id='idSearchString' size=25 style='vertical-align: 2' name='SearchString' display='inline' maxlength=255 ACCESSKEY=S class='ms-searchbox' onKeyDown="return SearchKeyDown(event, <%=strEncodedUrl%>);" title=<%SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SearchTextToolTip),Response.Output);%>>
    <IMG SRC="/_layouts/images/blank.gif" width=4 height=1 alt="">
    <a target='_self' href='javascript:' onClick="javascript:SubmitSearchRedirect(<%=strEncodedUrl%>);javascript:return false;" title=<%SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SearchImageToolTip),Response.Output);%> ACCESSKEY=O ID=onetIDGoSearch>
        <img border='0' src="/_layouts/images/FOLDER.GIF" style='vertical-align: 1'alt=<%SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SearchImageToolTip),Response.Output);%>></a>
    &nbsp;
    </span>
    </nobr>
    
  6. Em um prompt de comando, navegar para \Program Files\Common Files\Microsoft Shared\web server extensions\12\BIN sobre o local unidade e tipo cada os seguinte comandos para instalar o recurso na implantação, ativar o recurso em um subsite especificado e redefinir Serviços de Informações da Internet da Microsoft (IIS) para que as alterações tenham efeito:

                            stsadm -o installfeature -filename NewSearchBox\Feature.xml
    
    stsadm -o activatefeature -filename NewSearchBox\Feature.xml -url https://Server/Site/Subsite
    
    iisreset
    
  7. Navegue para o home page do subsite especificado para ver as alterações feitas a caixa de pesquisa.

Consulte também

Referência

DelegateControl

Conceitos

Delegar controle (Templatization de controle)
Controles de representante