Share via

PopupMenu.ShowForSelectionAsync Método

  • Referência

Definição

Namespace:
Windows.UI.Popups

Sobrecargas

ShowForSelectionAsync(Rect)

Mostra o menu de contexto acima da seleção especificada.
ShowForSelectionAsync(Rect, Placement)

Mostra o menu de contexto no posicionamento preferencial em relação à seleção especificada.

ShowForSelectionAsync(Rect)

Editar

Mostra o menu de contexto acima da seleção especificada.

public:
 virtual IAsyncOperation<IUICommand ^> ^ ShowForSelectionAsync(Rect selection) = ShowForSelectionAsync;
/// [Windows.Foundation.Metadata.Overload("ShowAsyncWithRect")]
IAsyncOperation<IUICommand> ShowForSelectionAsync(Rect const& selection);
[Windows.Foundation.Metadata.Overload("ShowAsyncWithRect")]
public IAsyncOperation<IUICommand> ShowForSelectionAsync(Rect selection);
function showForSelectionAsync(selection)
Public Function ShowForSelectionAsync (selection As Rect) As IAsyncOperation(Of IUICommand)

Parâmetros

selection
Rect

As coordenadas (em DIPs) do retângulo selecionado, em relação à janela. O menu de contexto é colocado diretamente acima e centralizado nesse retângulo de modo que a seleção não seja coberta.

Observação

Para VB, C#e C++, essa janela é o CoreWindow associado ao thread que está chamando o menu de contexto.

Retornos

IAsyncOperation<IUICommand>

Um objeto IUICommand que representa o comando de menu de contexto invocado pelo usuário, após a conclusão da chamada ShowForSelectionAsync.

Se nenhum comando for invocado, ShowForSelectionAsync retornará nulo.

Atributos
OverloadAttribute

Exemplos

Antes de mostrar um menu de contexto, você deve adicionar um ouvinte de eventos para o evento oncontextmenu . Por exemplo, o exemplo de menu Contexto escuta o evento em elementos HTML específicos e chama a scenario1AttachmentHandler função .

document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);

// We don't want to obscure content, so pass in the position representing the selection area.
menu.showForSelectionAsync(clientToWinRTRect(document.selection.createRange().getBoundingClientRect())).then(function (invokedCommand) {
    if (invokedCommand !== null) {
        switch (invokedCommand.id) {
            case 1: // Copy
                var selectedText = window.getSelection();
                copyTextToClipboard(selectedText);
                var message = "'Copy' button clicked and '" + /*@static_cast(String)*/selectedText + "' copied to clipboard";
                WinJS.log && WinJS.log(message, "sample", "status");
                break;
            case 2: // Highlight
                // Add command handler code here.
                WinJS.log && WinJS.log("'Highlight' button clicked", "sample", "status");
                break;
            case 3: // Look up
                // Add command handler code here.
                WinJS.log && WinJS.log("'Look up' button clicked", "sample", "status");
                break;
            default:
                break;
        }
    } else {
        // The command is null if no command was invoked.
        WinJS.log && WinJS.log("Context menu dismissed", "sample", "status");
    }
});

Além disso, o exemplo de menu Contexto usa duas funções auxiliares (getSelectionRect e getclientCoordinates) para definir as coordenadas do retângulo de seleção.

// Converts from client to WinRT coordinates, which take scale factor into consideration.
function clientToWinRTRect(rect) {
    var zoomFactor = document.documentElement.msContentZoomFactor;
    return {
        x: (rect.left + document.documentElement.scrollLeft - window.pageXOffset) * zoomFactor,
        y: (rect.top + document.documentElement.scrollTop - window.pageYOffset) * zoomFactor,
        width: rect.width * zoomFactor,
        height: rect.height * zoomFactor
    };
}

Comentários

Você pode ver exemplos de código completos que demonstram como criar e personalizar menus de contexto no exemplo de menu Contexto.

Confira também

Aplica-se a

ShowForSelectionAsync(Rect, Placement)

Editar

Mostra o menu de contexto no posicionamento preferencial em relação à seleção especificada.

public:
 virtual IAsyncOperation<IUICommand ^> ^ ShowForSelectionAsync(Rect selection, Placement preferredPlacement) = ShowForSelectionAsync;
/// [Windows.Foundation.Metadata.Overload("ShowAsyncWithRectAndPlacement")]
IAsyncOperation<IUICommand> ShowForSelectionAsync(Rect const& selection, Placement const& preferredPlacement);
[Windows.Foundation.Metadata.Overload("ShowAsyncWithRectAndPlacement")]
public IAsyncOperation<IUICommand> ShowForSelectionAsync(Rect selection, Placement preferredPlacement);
function showForSelectionAsync(selection, preferredPlacement)
Public Function ShowForSelectionAsync (selection As Rect, preferredPlacement As Placement) As IAsyncOperation(Of IUICommand)

Parâmetros

selection
Rect

As coordenadas (em DIPs) do retângulo selecionado, em relação à janela.

Observação

Para VB, C#e C++, essa janela é o CoreWindow associado ao thread que está chamando o menu de contexto.

preferredPlacement
Placement

O posicionamento preferencial do menu de contexto em relação ao retângulo de seleção.

O menu de contexto será posicionado no preferredPlacement se o menu se ajustar à janela e não cobrir a seleção. Se o menu de contexto não se ajustar ao posicionamento preferencial, outro posicionamento que não abrange a seleção será usado. Se o menu de contexto não se ajustar a nenhum outro lugar, um posicionamento que abrange parcial ou totalmente a seleção será usado.

Retornos

IAsyncOperation<IUICommand>

Um objeto IUICommand que representa o comando de menu de contexto invocado pelo usuário, após a conclusão da chamada ShowForSelectionAsync .

Se nenhum comando for invocado, ShowForSelectionAsync retornará nulo.

Atributos
OverloadAttribute

Exemplos

Antes de mostrar um menu de contexto, você deve adicionar um ouvinte de eventos para o evento oncontextmenu . Por exemplo, o exemplo de menu Contexto escuta o evento em elementos HTML específicos e chama a scenario1AttachmentHandler função .

document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);

// Converts from client to WinRT coordinates, which take scale factor into consideration.
function clientToWinRTRect(rect) {
    var zoomFactor = document.documentElement.msContentZoomFactor;
    return {
        x: (rect.left + document.documentElement.scrollLeft - window.pageXOffset) * zoomFactor,
        y: (rect.top + document.documentElement.scrollTop - window.pageYOffset) * zoomFactor,
        width: rect.width * zoomFactor,
        height: rect.height * zoomFactor
    };
}

Comentários

Você pode ver exemplos de código completos que demonstram como criar e personalizar menus de contexto no exemplo de menu Contexto.

Confira também

Aplica-se a