Compartilhar via


Como a: personalizar o selecionador de ativos

A ferramenta de selecionador do ativo permite que autores inserir facilmente um URL ou uma imagem a partir de qualquer SharePoint biblioteca ou lista na atual coleção site. Você pode usar o selecionador de ativo para inserir de conteúdo sem ter que tipo de URL que aponta para ele. O selecionador de ativo está disponível em muitos controles campo encontrado no editoração sites, como:

  • O controle campo HTML Editor

  • Controle de campo de imagem

  • A Web Part de Resumo Links

O painel Look In no lado esquerdo da janela de selecionador contém atalhos para bibliotecas SharePoint predefinidos. Esses atalhos projetados para ajudar autores de conteúdo localizar rápida e facilmente sem ter que navegar através das pastas na coleção de site. Na imagem selecionadores, esses apontar atalhos para:

  • A biblioteca imagem para o atual site

  • A biblioteca imagem para o atual coleção site

Em selecionadores URL, eles apontar para:

  • A biblioteca páginas para o atual site

  • Biblioteca de documento para o atual site

  • Biblioteca de documento para o atual coleção site

Se seu autores freqüentes precisará inserir documentos que não são encontrados nesses locais usar como padrão, você pode definir um atalho adicional apontando para outra localidade na coleção seu site. Você pode definir personalizado um atalho à imagem selecionadores e outro para selecionadores URL. Quando definido, esses atalhos aparecem no painel **** Look In próximo para os atalhos usar como padrão. Você pode definir personalizado atalhos de selecionador somente no escopo de um controle: após você editar a marcação para um controle em um arquivo modelo, somente selecionadores do ativo iniciados a partir desse exibir controle o personalizado especificado atalhos.

Personalizando o selecionador de ativos no nível do layout de página

Você pode definir um personalizado atalho de selecionador para um RichHtmlField ou um RichImageField RichImageField controle dentro um layout página:

  1. Navegue até \Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES\PublishingLayouts\PageLayouts e aberto um arquivo .aspx layout página.

  2. Localizar a publicação campo controle associado com o controle que usa o selecionador de ativo. For example, <PublishingWebControls:RichHtmlField> represents the HTML Editor field control.

  3. Adicionar uma ou ambas as seguinte atributos para essa marca:

    • DefaultAssetLocation: define o URL para o personalizado atalho em um seletor de URL.

    • DefaultAssetImageLocation: define o URL para o personalizado atalho no selecionador imagem.

      Essas URLs devem ser URLs Collection\endash Relative site aponta para uma biblioteca, lista ou outra localidade na coleção seu site, such as "/ReusableContent".

      For example, the following <PublishingWebControls:RichHtmlField> control defines the custom shortcuts /URLpicker and /imagepicker for URL and image pickers, respectively.

      <PublishingWebControls:RichHtmlField id="Content" Fieldname="PublishingPageContent" DefaultAssetLocation="/URLpicker" DefaultAssetImageLocation= "/imagepicker" runat="server"/>
      

      Similarly, the following <PublishingWebControls:RichHtmlField> control defines a custom shortcut for its image picker.

      <PublishingWebControls:RichImageField id="Content" Fieldname="PublishingPageImage" DefaultAssetImageLocation= "/imagepicker" runat="server"/>
      
  4. Salvar alterações e fechar o arquivo .aspx layout página.

Adicionar um controle AssetUrlSelector para qualquer página no seu aplicativo .aspx

You can add a <cms:AssetUrlSelector> server control to any .aspx page in your application. Este controle servidor processa um TextBox que exibe o URL selecionado no momento e um LinkButton que, quando clicado, executa o apropriado codificar JavaScript para iniciar a interface usuário Asset Picker.

You can use the following attributes of the <cms:AssetUrlSelector> control to customize the Asset Picker dialog box.

Atributo Descrição

DefaultOpenLocationUrl

Define a localidade usar como padrão onde o selecionador de ativo deve ser aberto.

DefaultsToLastUsedLocation

Definir como True para aberto a janela de selecionador do ativo na localidade usada última. O primeiro usar o selecionador de ativo, ele abrirá na localidade especificada pelo DefaultOpenLocationUrl DefaultOpenLocationUrl propriedade.

Definir como False se você sempre desejar seja aberto na localidade especificada no DefaultOpenLocationUrl.

DisplayLookInSection

Definir como True para exibir um Look In seção na janela de selecionador de ativo. Caso contrário, definir a False.

OverrideDialogFeatures

Substitui vários propriedades de caixa diálogo Asset Picker.

OverrideDialogTitle

Define o título da caixa diálogo Asset Picker.

OverrideDialogDescription

Define a descrição exibida perto de parte superior da caixa diálogo Asset Picker.

OverrideDialogImageUrl

Define o ícone exibido na parte superior-direito da caixa diálogo Asset Picker.

AssetTextClientID

Quando especificado, essa identificação é usada para localizar o elemento HTML para o valor AssetText retornado pelo Selecionador de ativo.

Padrões para o ClientID do controle TextBox filho.

AsserUrlClientID

Quando especificado, essa identificação é usada para localizar o elemento HTML para o valor AssetUrl que retorna o selecionador de ativo.

Padrões para o ClientID do controle TextBox filho.

ClientCallback

Um seqüência de caracteres que contém uma função JavaScript para chamar quando a caixa diálogo de selecionador do ativo retorna um valor.

Padrões para String.Empty.

UseImageAssetPicker

Defina como True para usar a versão imagem do Selecionador de ativo.

Defina como False para usar a versão URL. Selecionador de imagem abre Por padrão na exibição de miniaturas. Se um usuário seleciona um URL que não apontar para uma imagem, o aplicativo avisa o usuário.

AllowExternalURLs

Defina como True para permitir externo URLs seja especificado.

O usar como padrão é False.

AssetUrlTextBoxVisible

Definir como False para ocultar o caixa de texto URL.

O usar como padrão é True.

AssetPickerButtonVisible

Definir como False para ocultar o botão que inicia a janela Seletor.

O usar como padrão é True.

AutoPostBack

Definir como True para causar o Asset Picker para automaticamente postagem voltar quando o usuário altera o URL selecionada digitando diretamente no caixa de texto, ou seleciona um item diferente na janela de selecionador de ativo. O usar como padrão é False.

AsserUrlClientID

Quando especificado, essa identificação é usada para localizar o elemento HTML para o valor retornado AssetUrl retornado pelo Selecionador de ativo.

Padrões para o ClientID do controle TextBox filho.

Exemplo

This example <cms:AssetUrlSelector> control uses many of the available attributes.

<CMS:AssetUrlSelector
    DefaultOpenLocationUrl="~SiteCollection/"
    DefaultToLastUsedLocation="false"
    DisplayLookInSection="true"
    OverrideDialogFeatures="resizable: no; status: yes; scroll: yes; help: no; dialogWidth:500px; dialogHeight:500px;"
    OverrideDialogTitle="Custom Picker Title"
    OverrideDialogDescription="Custom Picker Description"
    OverrideDialogImageUrl="~Site/PublishingImages/AssetPickerLogo.jpg"
    AssetTextClientID="testAssetTextClientIDCust"
    ClientCallback="function(returnedUrl) { window.alert('ClientCallback[AssetTextClientID]: ' + returnedUrl); }"
    id="assetSelectedImageCustomLauncher" 
    UseImageAssetPicker=true 
    runat="server" />