PopupMenu.ShowForSelectionAsync Metodo

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)

Parametri

Restituisce

Oggetto IUICommand che rappresenta il comando del menu di scelta rapida richiamato dall'utente, dopo il completamento della chiamata ShowForSelectionAsync.

Se non viene richiamato alcun comando, ShowForSelectionAsync restituisce Null.

Attributi

OverloadAttribute

Esempio

Prima di poter visualizzare un menu di scelta rapida, è necessario aggiungere un listener eventi per l'evento oncontextmenu . Ad esempio, l'esempio di menu Contestuale ascolta l'evento su elementi HTML specifici e quindi chiama la scenario1AttachmentHandler funzione.

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");
    }
});

Inoltre, l'esempio di menu di scelta rapida usa due funzioni helper (getSelectionRect e getclientCoordinates) per impostare le coordinate per il rettangolo di selezione.

// 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
    };
}

Commenti

È possibile visualizzare esempi di codice completi che illustrano come creare e personalizzare i menu di scelta rapida nell'esempio di menu di scelta rapida.

Vedi anche

• IUICommand
• Rect
• ShowForSelectionAsync(Rect, Placement)
• UICommand
• Aggiunta di menu di scelta rapida
• Esempio di menu di scelta rapida
• Linee guida ed elenco di controllo per
• oncontextmenu

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)

Parametri

Restituisce

Oggetto IUICommand che rappresenta il comando del menu di scelta rapida richiamato dall'utente, dopo il completamento della chiamata ShowForSelectionAsync .

Se non viene richiamato alcun comando, ShowForSelectionAsync restituisce Null.

Attributi

OverloadAttribute

Esempio

Prima di poter visualizzare un menu di scelta rapida, è necessario aggiungere un listener eventi per l'evento oncontextmenu . Ad esempio, l'esempio di menu Contestuale ascolta l'evento su elementi HTML specifici e quindi chiama la scenario1AttachmentHandler funzione.

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
    };
}

Commenti

È possibile visualizzare esempi di codice completi che illustrano come creare e personalizzare i menu di scelta rapida nell'esempio di menu di scelta rapida.

Vedi anche

• IUICommand
• Rect
• ShowForSelectionAsync(Rect)
• UICommand
• Aggiunta di menu di scelta rapida
• Esempio di menu di scelta rapida
• Linee guida ed elenco di controllo per
• oncontextmenu