Comportamento del controllo Popup in relazione al posizionamentoPopup Placement Behavior

Un Popup controllo Visualizza il contenuto in una finestra separata che è mobile su un'applicazione.A Popup control displays content in a separate window that floats over an application. È possibile specificare la posizione di un Popup oggetto rispetto a un controllo, al mouse o alla schermata usando le PlacementTargetproprietà, Placement, PlacementRectangle, HorizontalOffsete VerticalOffset .You can specify the position of a Popup relative to a control, the mouse, or the screen by using the PlacementTarget, Placement, PlacementRectangle, HorizontalOffset, and VerticalOffset properties. Queste proprietà interagiscono per offrire la flessibilità necessaria per specificare la posizione di Popup.These properties work together to give you flexibility in specifying the position of the Popup.

Nota

Le ToolTip classi ContextMenu e definiscono anche queste cinque proprietà e si comportano in modo simile.The ToolTip and ContextMenu classes also define these five properties and behave similarly.

Posizionamento del controllo PopupPositioning the Popup

La posizione di un Popup oggetto può essere relativa a UIElement un oggetto o all'intero schermo.The placement of a Popup can be relative to a UIElement or to the entire screen. Nell'esempio seguente vengono creati Popup quattro controlli relativi a un oggetto UIElement, in questo caso un'immagine.The following example creates four Popup controls that are relative to a UIElement—in this case, an image. Per tutti i Popup controlli PlacementTarget la proprietà è impostata su image1, ma ognuna Popup presenta un valore diverso per la proprietà Placement.All of the Popup controls have the PlacementTarget property set to image1, but each Popup has a different value for the placement property.

<Canvas Width="200" Height="150">
  <Image Name="image1"
         Canvas.Left="75" 
         Source="Water_lilies.jpg" Height="200" Width="200"/>
  <Popup IsOpen="True" PlacementTarget="{Binding ElementName=image1}"
         Placement="Bottom">
    <TextBlock FontSize="14" Background="LightGreen">Placement=Bottom</TextBlock>

  </Popup>
  <Popup IsOpen="True" PlacementTarget="{Binding ElementName=image1}"
         Placement="Top">
    <TextBlock FontSize="14" Background="LightGreen">Placement=Top</TextBlock>

  </Popup>
  <Popup IsOpen="True" PlacementTarget="{Binding ElementName=image1}"
         Placement="Left">
    <TextBlock FontSize="14" Background="LightGreen">Placement=Left</TextBlock>

  </Popup>
  <Popup IsOpen="True" PlacementTarget="{Binding ElementName=image1}"
         Placement="Right">
    <TextBlock FontSize="14" Background="LightGreen">Placement=Right</TextBlock>

  </Popup>
</Canvas>

La figura seguente illustra l'immagine e i Popup controlliThe following illustration shows the image and the Popup controls

Immagine con quattro controlli popupImage with four popup controls

Questo semplice esempio illustra come impostare le PlacementTarget proprietà e Placement , ma usando le PlacementRectangleproprietà, HorizontalOffset Popup e VerticalOffset , si ha un maggiore controllo sulla posizione in cui è posizionato.This simple example demonstrates how to set the PlacementTarget and Placement properties, but by using the PlacementRectangle, HorizontalOffset, and VerticalOffset properties, you have even more control over where the Popup is positioned.

Definizioni dei termini: Anatomia di un popupDefinitions of Terms: The Anatomy of a Popup

I termini seguenti sono utili per comprendere il modo PlacementTargetin Placementcui PlacementRectanglele proprietà, VerticalOffset ,, HorizontalOffsete sono correlate tra loro Popupe:The following terms are useful in understanding how the PlacementTarget, Placement, PlacementRectangle, HorizontalOffset, and VerticalOffset properties relate to each other and the Popup:

  • Oggetto destinazioneTarget object

  • Area di destinazioneTarget area

  • Origine di destinazioneTarget origin

  • Punto di allineamento del controllo PopupPopup alignment point

Questi termini costituiscono un modo pratico per fare riferimento a diversi aspetti di Popup e al controllo a cui è associato.These terms provide a convenient way to refer to various aspects of the Popup and the control that it is associated with.

Oggetto di destinazioneTarget Object

L' oggetto di destinazione è l'elemento a Popup cui è associato.The target object is the element that the Popup is associated with. Se la PlacementTarget proprietà è impostata, viene specificato l'oggetto di destinazione.If the PlacementTarget property is set, it specifies the target object. Se PlacementTarget non è impostato Popup e ha un padre, l'elemento padre è l'oggetto di destinazione.If PlacementTarget is not set, and the Popup has a parent, the parent is the target object. Se non è PlacementTarget presente alcun valore e nessun elemento padre, non è presente alcun oggetto di Popup destinazione e l'oggetto viene posizionato in relazione allo schermo.If there is no PlacementTarget value and no parent, there is no target object, and the Popup is positioned relative to the screen.

Nell'esempio seguente viene creato Popup un oggetto che è l'elemento Canvasfiglio di un oggetto.The following example creates a Popup that is the child of a Canvas. Nell'esempio non viene impostata la PlacementTarget proprietà nell'oggetto Popup.The example does not set the PlacementTarget property on the Popup. Il valore predefinito per Placement è PlacementMode.Bottom Popup ,Canvasquindi viene visualizzato sotto.The default value for Placement is PlacementMode.Bottom, so the Popup appears below the Canvas.

<Canvas Margin="5" Background="Red" Width="200" Height="150" >

  <Ellipse Canvas.Top="60" Canvas.Left="50"
           Height="85" Width="60" 
           Fill="Black"/>

  <Popup IsOpen="True" >
    <TextBlock Background="LightBlue" FontSize="18">This is a Popup</TextBlock>
  </Popup>
</Canvas>

Nella figura seguente viene illustrato che Popup l'oggetto è posizionato in Canvasrelazione all'oggetto.The following illustration shows that the Popup is positioned relative to the Canvas.

Controllo popup senza PlacementTargetPopup control with no PlacementTarget

Nell'esempio seguente viene creato Popup un oggetto che è l'elemento Canvasfiglio di un oggetto PlacementTarget , ma questa volta ellipse1è impostato Ellipsesu, quindi la finestra popup viene visualizzata sotto.The following example creates a Popup that is the child of a Canvas, but this time the PlacementTarget is set to ellipse1, so the popup appears below the Ellipse.

<Canvas Margin="5" Background="Red" Width="200" Height="150" >

  <Ellipse Name="ellipse1"
           Canvas.Top="60" Canvas.Left="50"
           Height="85" Width="60" 
           Fill="Black"/>

  <Popup IsOpen="True" PlacementTarget="{Binding ElementName=ellipse1}">
    <TextBlock Background="LightBlue" FontSize="18">This is a Popup</TextBlock>
  </Popup>
</Canvas>

Nella figura seguente viene illustrato che Popup l'oggetto è posizionato in Ellipserelazione all'oggetto.The following illustration shows that the Popup is positioned relative to the Ellipse.

Popup posizionato in relazione a un'ellissePopup positioned relative to an ellipse

Nota

Per ToolTip, il valore predefinito di Placement è Mouse.For ToolTip, the default value of Placement is Mouse. Per ContextMenu, il valore predefinito di Placement è MousePoint.For ContextMenu, the default value of Placement is MousePoint. Questi valori vengono descritti più avanti nella sezione "Modalità di interazione delle proprietà".These values are explained later, in "How the Properties Work Together."

Area di destinazioneTarget Area

L' area di destinazione è l'area sullo schermo a cui Popup è relativo.The target area is the area on the screen that the Popup is relative to. Negli esempi precedenti, Popup è allineato con i limiti dell'oggetto di destinazione, ma in alcuni casi Popup è allineato ad altri limiti, anche se Popup dispone di un oggetto di destinazione.In the previous examples, the Popup is aligned with the bounds of the target object, but in some cases, the Popup is aligned to other bounds, even if the Popup has a target object. Se la PlacementRectangle proprietà è impostata, l'area di destinazione è diversa dai limiti dell'oggetto di destinazione.If the PlacementRectangle property is set, the target area is different than the bounds of the target object.

Nell'esempio seguente vengono creati Canvas due oggetti, ognuno dei quali Rectangle contiene un Popupoggetto e un oggetto.The following example creates two Canvas objects, each one containing a Rectangle and a Popup. In entrambi i casi, l'oggetto di destinazione Popup per Canvasè.In both cases, the target object for the Popup is the Canvas. PlacementRectangle Width NelprimoHeight è impostato il set, Ycon le proprietà ,,eimpostaterispettivamentesu50,50,50e100.X Canvas PopupThe Popup in the first Canvas has the PlacementRectangle set, with its X, Y, Width, and Height properties set to 50, 50, 50, and 100, respectively. Nel secondo Canvas non è impostato il PlacementRectangle set. PopupThe Popup in the second Canvas does not have the PlacementRectangle set. Di conseguenza, il Popup primo è posizionato al di PlacementRectangle sotto di e il Popup Canvassecondo è posizionato sotto.As a result, the first Popup is positioned below the PlacementRectangle and the second Popup is positioned below the Canvas. Ogni Canvas contiene anche un Rectangle oggetto con gli PlacementRectangle stessi limiti di per la prima Popup.Each Canvas also contains a Rectangle that has the same bounds as the PlacementRectangle for the first Popup. Si noti che PlacementRectangle non crea un elemento visibile nell'applicazione. nell'esempio viene creato un oggetto Rectangle per rappresentare PlacementRectangle.Note that the PlacementRectangle does not create a visible element in the application; the example creates a Rectangle to represent the PlacementRectangle.

<StackPanel Orientation="Horizontal" Margin="50,50,0,0">

  <Canvas Width="200" Height="200" Background="Red">
    <Rectangle Canvas.Top="50" Canvas.Left="50" 
               Width="50" Height="100"
               Stroke="White" StrokeThickness="3"/>
    <Popup IsOpen="True" PlacementRectangle="50,50,50,100">
      <TextBlock FontSize="14" Background="Yellow"
                 Width="140" TextWrapping="Wrap">
        This is a popup with a PlacementRectangle.
      </TextBlock>
    </Popup>
  </Canvas>
  
  <Canvas Width="200" Height="200" Background="Red" Margin="30,0,0,0">
    <Rectangle Canvas.Top="50" Canvas.Left="50" 
               Width="50" Height="100"
               Stroke="White" StrokeThickness="3"/>
    <Popup IsOpen="True">
      <TextBlock FontSize="14" Background="Yellow"
                 Width="140" TextWrapping="Wrap">
        This is a popup without a PlacementRectangle.
      </TextBlock>
    </Popup>
  </Canvas>
  
</StackPanel>

La figura seguente illustra il risultato dell'esempio precedente.The following illustration shows the result of the preceding example.

Popup con e senza PlacementRectanglePopup with and without PlacementRectangle

Origine di destinazione e punto di allineamento del controllo PopupTarget Origin and Popup Alignment Point

L'origine di destinazione e il punto di allineamento del controllo Popup sono punti di riferimento, rispettivamente sull'area di destinazione e sul popup, usati per il posizionamento.The target origin and popup alignment point are reference points on the target area and popup, respectively, that are used for positioning. È possibile usare le HorizontalOffset proprietà VerticalOffset e per compensare il popup dall'area di destinazione.You can use the HorizontalOffset and VerticalOffset properties to offset the popup from the target area. HorizontalOffset EVerticalOffset sono relativi all'origine di destinazione e al punto di allineamento del popup.The HorizontalOffset and VerticalOffset are relative to the target origin and the popup alignment point. Il valore della Placement proprietà determina la posizione in cui si trovano l'origine di destinazione e il punto di allineamento del popup.The value of the Placement property determines where the target origin and popup alignment point are located.

Nell'esempio seguente viene creato Popup un oggetto e HorizontalOffset le VerticalOffset proprietà e vengono impostate su 20.The following example creates a Popup and sets the HorizontalOffset and VerticalOffset properties to 20. La Placement proprietà è impostata su Bottom (impostazione predefinita), quindi l'origine di destinazione è l'angolo inferiore sinistro dell'area di destinazione e il punto di allineamento è l'angolo superiore sinistro dell'oggetto Popup.The Placement property is set to Bottom (the default), so the target origin is the bottom-left corner of the target area and the popup alignment point is the top-left corner of the Popup.

<Canvas Width="200" Height="200" Background="Yellow" Margin="20">
  <Popup IsOpen="True" Placement="Bottom"
         HorizontalOffset="20" VerticalOffset="20">
    <TextBlock FontSize="14" Background="#42F3FD">
      This is a popup.
    </TextBlock>
  </Popup>
</Canvas>

La figura seguente illustra il risultato dell'esempio precedente.The following illustration shows the result of the preceding example.

Posizionamento popup con punto di allineamento origine destinazionePopup placement with target origin alignment point

Modalità di interazione delle proprietàHow the Properties Work Together

I valori di PlacementTarget, PlacementRectanglee Placement devono essere considerati insieme per individuare l'area di destinazione, l'origine di destinazione e il punto di allineamento del popup corretti.The values of PlacementTarget, PlacementRectangle, and Placement need to be considered together to figure out the correct target area, target origin, and popup alignment point. Se, ad esempio, il valore Placement di Mouseè, non è presente PlacementRectangle alcun oggetto di destinazione, viene ignorato e l'area di destinazione è il limite del puntatore del mouse.For example, if the value of Placement is Mouse, there is no target object, the PlacementRectangle is ignored, and the target area is the bounds of the mouse pointer. D'altra parte, Placement se è Bottom, l' PlacementTarget elemento padre di o determina l'oggetto di PlacementRectangle destinazione e determina l'area di destinazione.On the other hand, if Placement is Bottom, the PlacementTarget or parent determines the target object and PlacementRectangle determines the target area.

Nella tabella seguente vengono descritti l'oggetto di destinazione, l'area di destinazione, l'origine di destinazione e il PlacementTarget punto PlacementRectangle di allineamento del popup PlacementMode e viene indicato se e vengono utilizzati per ogni valore di enumerazione.The following table describes the target object, target area, target origin, and popup alignment point and indicates whether PlacementTarget and PlacementRectangle are used for each PlacementMode enumeration value.

PlacementModePlacementMode Oggetto destinazioneTarget object Area di destinazioneTarget area Origine di destinazioneTarget origin Punto di allineamento del controllo PopupPopup alignment point
Absolute Non applicabile.Not applicable. PlacementTargetviene ignorato.PlacementTarget is ignored. Schermata o PlacementRectangle se è impostata.The screen, or PlacementRectangle if it is set. PlacementRectangle È relativo allo schermo.The PlacementRectangle is relative to the screen. Angolo superiore sinistro dell'area di destinazione.The top-left corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
AbsolutePoint Non applicabile.Not applicable. PlacementTargetviene ignorato.PlacementTarget is ignored. Schermata o PlacementRectangle se è impostata.The screen, or PlacementRectangle if it is set. PlacementRectangle È relativo allo schermo.The PlacementRectangle is relative to the screen. Angolo superiore sinistro dell'area di destinazione.The top-left corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
Bottom PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Angolo inferiore sinistro dell'area di destinazione.The bottom-left corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
Center PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Centro dell'area di destinazione.The center of the target area. Centro dell'oggetto Popup.The center of the Popup.
Custom PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Definito da CustomPopupPlacementCallback.Defined by the CustomPopupPlacementCallback. Definito da CustomPopupPlacementCallback.Defined by the CustomPopupPlacementCallback.
Left PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Angolo superiore sinistro dell'area di destinazione.The top-left corner of the target area. Angolo superiore destro dell'oggetto Popup.The top-right corner of the Popup.
Mouse Non applicabile.Not applicable. PlacementTargetviene ignorato.PlacementTarget is ignored. Limiti del puntatore del mouse.The bounds of the mouse pointer. PlacementRectangleviene ignorato.PlacementRectangle is ignored. Angolo inferiore sinistro dell'area di destinazione.The bottom-left corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
MousePoint Non applicabile.Not applicable. PlacementTargetviene ignorato.PlacementTarget is ignored. Limiti del puntatore del mouse.The bounds of the mouse pointer. PlacementRectangleviene ignorato.PlacementRectangle is ignored. Angolo superiore sinistro dell'area di destinazione.The top-left corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
Relative PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Angolo superiore sinistro dell'area di destinazione.The top-left corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
RelativePoint PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Angolo superiore sinistro dell'area di destinazione.The top-left corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
Right PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Angolo superiore destro dell'area di destinazione.The top-right corner of the target area. Angolo superiore sinistro dell'oggetto Popup.The top-left corner of the Popup.
Top PlacementTargeto padre.PlacementTarget or parent. Oggetto di destinazione o PlacementRectangle se è impostato.The target object, or PlacementRectangle if it is set. PlacementRectangle È relativo all'oggetto di destinazione.The PlacementRectangle is relative to the target object. Angolo superiore sinistro dell'area di destinazione.The top-left corner of the target area. Angolo inferiore sinistro di Popup.The bottom-left corner of the Popup.

Le illustrazioni seguenti mostrano l' Popuparea di destinazione, l'origine di destinazione e il punto di allineamento PlacementMode del popup per ogni valore.The following illustrations show the Popup, target area, target origin, and popup alignment point for each PlacementMode value. In ogni figura l'area di destinazione è gialla e Popup è blu.In each figure, the target area is yellow, and the Popup is blue.

Popup con posizionamento assoluto o AbsolutePointPopup with Absolute or AbsolutePoint placement

![Popup con posizionamento inferiore] Il (./media/popup-placement-behavior/popup-placement-bottom.png "posizionamento è inferiore.")Popup with Bottom placement

![Popup con posizionamento centrato] Il (./media/popup-placement-behavior/popup-placement-center.png "posizionamento è al centro.")Popup with Center placement

Popup con posizionamento a sinistraPopup with Left placement

![Popup con posizionamento del mouse] Il (./media/popup-placement-behavior/popup-placement-mouse.png "posizionamento è mouse.")Popup with Mouse placement

![Popup con selezione host MousePoint] Il (./media/popup-placement-behavior/popup-placement-mousepoint.png "posizionamento è MousePoint.")Popup with MousePoint placement

Popup con posizionamento relativo o RelativePointPopup with Relative or RelativePoint placement

Popup con posizionamento a destraPopup with Right placement

![Popup con posizionamento superiore] Il (./media/popup-placement-behavior/popup-placement-top.png "posizionamento è top.")Popup with Top placement

Rilevamento dei bordi dello schermo da parte del controllo PopupWhen the Popup Encounters the Edge of the Screen

Per motivi di sicurezza, Popup un oggetto non può essere nascosto dal bordo di una schermata.For security reasons, a Popup cannot be hidden by the edge of a screen. Una delle tre situazioni seguenti si verifica quando Popup rileva un bordo dello schermo:One of the following three things happens when the Popup encounters a screen edge:

  • Il popup viene riallineato lungo il bordo dello schermo che nasconderebbe Popup.The popup realigns itself along the screen edge that would obscure the Popup.

  • Il popup usa un punto di allineamento diverso.The popup uses a different popup alignment point.

  • Il popup usa un'origine di destinazione e un punto di allineamento diversi.The popup uses a different target origin and popup alignment point.

Tali opzioni vengono descritte più avanti in questa sezione.These options are described further later in this section.

Il comportamento di Popup quando rileva un bordo dello schermo dipende dal valore Placement della proprietà e dal bordo dello schermo rilevato dal popup.The behavior of the Popup when it encounters a screen edge depends on the value of the Placement property and which screen edge the popup encounters. Nella tabella seguente viene riepilogato il comportamento quando Popup rileva un bordo dello schermo per ogni PlacementMode valore.The following table summarizes the behavior when the Popup encounters a screen edge for each PlacementMode value.

PlacementModePlacementMode Bordo superioreTop edge Bordo inferioreBottom edge Bordo sinistroLeft edge Bordo destroRight edge
Absolute Allineamento al bordo superiore.Aligns to the top edge. Allineamento al bordo inferiore.Aligns to the bottom edge. Allineamento al bordo sinistro.Aligns to the left edge. Allineamento al bordo destro.Aligns to the right edge.
AbsolutePoint Allineamento al bordo superiore.Aligns to the top edge. Il punto di allineamento del popup viene modificato nell'angolo inferiore sinistro di Popup.The popup alignment point changes to the bottom-left corner of the Popup. Allineamento al bordo sinistro.Aligns to the left edge. Il punto di allineamento del popup viene modificato nell'angolo superiore destro dell' Popupoggetto.The popup alignment point changes to the top-right corner of the Popup.
Bottom Allineamento al bordo superiore.Aligns to the top edge. L'origine di destinazione viene modificata nell'angolo superiore sinistro dell'area di destinazione e il punto di allineamento viene modificato nell'angolo inferiore sinistro di Popup.The target origin changes to the top-left corner of the target area and the popup alignment point changes to the bottom-left corner of the Popup. Allineamento al bordo sinistro.Aligns to the left edge. Allineamento al bordo destro.Aligns to the right edge.
Center Allineamento al bordo superiore.Aligns to the top edge. Allineamento al bordo inferiore.Aligns to the bottom edge. Allineamento al bordo sinistro.Aligns to the left edge. Allineamento al bordo destro.Aligns to the right edge.
Left Allineamento al bordo superiore.Aligns to the top edge. Allineamento al bordo inferiore.Aligns to the bottom edge. L'origine di destinazione viene modificata nell'angolo superiore destro dell'area di destinazione e il punto di allineamento viene modificato nell'angolo superiore sinistro di Popup.The target origin changes to the top-right corner of the target area and the popup alignment point changes to the top-left corner of the Popup. Allineamento al bordo destro.Aligns to the right edge.
Mouse Allineamento al bordo superiore.Aligns to the top edge. L'origine di destinazione viene modificata nell'angolo superiore sinistro dell'area di destinazione (i limiti del puntatore del mouse) e il punto di allineamento viene modificato nell'angolo inferiore sinistro di Popup.The target origin changes to the top-left corner of the target area (the bounds of the mouse pointer) and the popup alignment point changes to the bottom-left corner of the Popup. Allineamento al bordo sinistro.Aligns to the left edge. Allineamento al bordo destro.Aligns to the right edge.
MousePoint Allineamento al bordo superiore.Aligns to the top edge. Il punto di allineamento del popup viene modificato nell'angolo inferiore sinistro di Popup.The popup alignment point changes to the bottom-left corner of the Popup. Allineamento al bordo sinistro.Aligns to the left edge. Il punto di allineamento viene modificato nell'angolo superiore destro del controllo Popup.The popup alignment point changes to the top-right corner of the popup.
Relative Allineamento al bordo superiore.Aligns to the top edge. Allineamento al bordo inferiore.Aligns to the bottom edge. Allineamento al bordo sinistro.Aligns to the left edge. Allineamento al bordo destro.Aligns to the right edge.
RelativePoint Allineamento al bordo superiore.Aligns to the top edge. Il punto di allineamento del popup viene modificato nell'angolo inferiore sinistro di Popup.The popup alignment point changes to the bottom-left corner of the Popup. Allineamento al bordo sinistro.Aligns to the left edge. Il punto di allineamento viene modificato nell'angolo superiore destro del controllo Popup.The popup alignment point changes to the top-right corner of the popup.
Right Allineamento al bordo superiore.Aligns to the top edge. Allineamento al bordo inferiore.Aligns to the bottom edge. Allineamento al bordo sinistro.Aligns to the left edge. L'origine di destinazione viene modificata nell'angolo superiore sinistro dell'area di destinazione e il punto di allineamento viene modificato nell'angolo superiore destro dell'oggetto Popup.The target origin changes to the top-left corner of the target area and the popup alignment point changes to the top-right corner of the Popup.
Top L'origine di destinazione viene modificata nell'angolo inferiore sinistro dell'area di destinazione e il punto di allineamento viene modificato nell'angolo superiore sinistro di Popup.The target origin changes to the bottom-left corner of the target area and the popup alignment point changes to the top-left corner of the Popup. In effetti, questo è lo stesso di quando Placement è Bottom.In effect, this is the same as when Placement is Bottom. Allineamento al bordo inferiore.Aligns to the bottom edge. Allineamento al bordo sinistro.Aligns to the left edge. Allineamento al bordo destro.Aligns to the right edge.

Allineamento al bordo dello schermoAligning to the Screen Edge

Un Popup oggetto può essere allineato al bordo dello schermo riposizionando se stesso in Popup modo che l'intero sia visibile sullo schermo.A Popup can align to the edge of the screen by repositioning itself so the entire Popup is visible on the screen. In tal caso, la distanza tra l'origine di destinazione e il punto di allineamento del popup potrebbe essere HorizontalOffset diversa VerticalOffsetdai valori di e.When this occurs, the distance between the target origin and popup alignment point might differ from the values of HorizontalOffset and VerticalOffset. Quando Placement è Absolute, oCenter ,l'Popup oggetto si allinea a ogni bordo dello schermo. RelativeWhen Placement is Absolute, Center, or Relative, the Popup aligns itself to every screen edge. Si supponga, ad esempio, che Placement sia impostato Relative su VerticalOffset e che sia impostato su 100. PopupFor example, assume that a Popup has Placement set to Relative and VerticalOffset set to 100. Se il bordo inferiore dello schermo nasconde tutto o parte dell'oggetto Popup Popup , viene riposizionato lungo il bordo inferiore dello schermo e la distanza verticale tra l'origine di destinazione e il punto di allineamento del popup è inferiore a 100.If the bottom edge of the screen hides all or part of the Popup, the Popup repositions itself along the bottom edge of the screen and the vertical distance between the target origin and popup alignment point is less than 100. La figura seguente illustra questa situazione.The following illustration demonstrates this.

Popup che è allineato al bordo dello schermoPopup that aligns to edge of screen

Modifica del punto di allineamento del controllo PopupChanging the Popup Alignment Point

Se Placement è AbsolutePoint, RelativePointo ,ilpuntodiallineamentodelpopupvienemodificatoquandoilpopuprilevailbordoinferioreodestrodelloschermo.MousePointIf Placement is AbsolutePoint, RelativePoint, or MousePoint, the popup alignment point changes when the popup encounters the bottom or right screen edge.

Nell'illustrazione seguente viene dimostrato che quando il bordo inferiore dello schermo nasconde tutto o parte di Popup, il punto di allineamento del popup è l'angolo inferiore sinistro Popupdi.The following illustration demonstrates that when the bottom screen edge hides all or part of the Popup, the popup alignment point is the bottom-left corner of the Popup.

Nuovo punto di allineamento dovuto al bordo inferiore dello schermoNew alignment point due to bottom screen edge

Nell'illustrazione seguente viene dimostrato che quando Popup è nascosto dal bordo destro dello schermo, il punto di allineamento del popup è l'angolo superiore destro dell' Popupoggetto.The following illustration demonstrates that when the Popup is hidden by the right screen edge, the popup alignment point is the top-right corner of the Popup.

Nuovo punto di allineamento popup dovuto al bordo dello schermoNew popup alignment point due to screen edge

Se rileva i bordi inferiore e destro dello schermo, il punto Popupdi allineamento del popup è l'angolo inferiore destro di. PopupIf the Popup encounters the bottom and right screen edges, the popup alignment point is the bottom-right corner of the Popup.

Modifica dell'origine di destinazione e del punto di allineamento del controllo PopupChanging the Target Origin and Popup Alignment Point

Quando Placement è Bottom, ,Left ,oTop, l'origine di destinazione e il punto di allineamento del popup cambiano se viene rilevato un determinato bordo dello schermo. Mouse RightWhen Placement is Bottom, Left, Mouse, Right, or Top, the target origin and popup alignment point change if a certain screen edge is encountered. Il bordo dello schermo che determina la modifica della posizione dipende PlacementMode dal valore.The screen edge that causes the position to change depends on the PlacementMode value.

Nell'illustrazione seguente viene dimostrato che Placement quando Bottom è e Popup rileva il bordo inferiore dello schermo, l'origine di destinazione è l'angolo superiore sinistro dell'area di destinazione e il punto di allineamento del popup è l'angolo inferiore sinistro del Popup.The following illustration demonstrates that when Placement is Bottom and the Popup encounters the bottom screen edge, the target origin is the top-left corner of the target area and the popup alignment point is the bottom-left corner of the Popup.

![Nuovo punto di allineamento dovuto al bordo inferiore dello schermo] Il (./media/popup-placement-behavior/popup-placement-bottom-screen-edge.png "posizionamento è inferiore e il popup rileva il bordo inferiore dello schermo.")New alignment point due to bottom screen edge

Nell'illustrazione seguente viene dimostrato che Placement quando Left è e Popup rileva il bordo sinistro della schermata, l'origine di destinazione è l'angolo superiore destro dell'area di destinazione e il punto di allineamento del popup è l'angolo superiore sinistro del Popup.The following illustration demonstrates that when Placement is Left and the Popup encounters the left screen edge, the target origin is the top-right corner of the target area and the popup alignment point is the top-left corner of the Popup.

Nuovo punto di allineamento dovuto al bordo sinistro dello schermoNew alignment point due to left screen edge

Nell'illustrazione seguente viene dimostrato che Placement quando Right è e Popup rileva il bordo destro dello schermo, l'origine di destinazione è l'angolo superiore sinistro dell'area di destinazione e il punto di allineamento è l'angolo superiore destro della Popup.The following illustration demonstrates that when Placement is Right and the Popup encounters the right screen edge, the target origin is the top-left corner of the target area and the popup alignment point is the top-right corner of the Popup.

![Nuovo punto di allineamento dovuto al bordo destro dello schermo] Il (./media/popup-placement-behavior/popup-placement-right-screen-edge.png "posizionamento è a destra e il popup rileva il bordo destro dello schermo.")New alignment point due to right screen edge

Nell'illustrazione seguente viene dimostrato che Placement quando Top è e Popup rileva il bordo superiore dello schermo, l'origine di destinazione è l'angolo inferiore sinistro dell'area di destinazione e il punto di allineamento del popup è l'angolo superiore sinistro del Popup.The following illustration demonstrates that when Placement is Top and the Popup encounters the top screen edge, the target origin is the bottom-left corner of the target area and the popup alignment point is the top-left corner of the Popup.

![Nuovo punto di allineamento dovuto al bordo superiore dello schermo] Il (./media/popup-placement-behavior/popup-placement-top-screen-edge.png "posizionamento è top e il popup rileva il bordo superiore dello schermo.")New alignment point due to top screen edge

Nell'illustrazione seguente viene dimostrato che Placement quando Mouse è e Popup rileva il bordo inferiore dello schermo, l'origine di destinazione è l'angolo superiore sinistro dell'area di destinazione (i limiti del puntatore del mouse) e l'allineamento del popup. Point è l'angolo inferiore sinistro di Popup.The following illustration demonstrates that when Placement is Mouse and the Popup encounters the bottom screen edge, the target origin is the top-left corner of the target area (the bounds of the mouse pointer) and the popup alignment point is the bottom-left corner of the Popup.

nuovo punto di allineamento dovuto al mouse vicino al bordo dello schermonew alignment point due to mouse near screen edge

Personalizzazione del posizionamento di un controllo PopupCustomizing Popup Placement

È possibile personalizzare l'origine di destinazione e il punto di allineamento del Placement popup impostando la proprietà su. CustomYou can customize the target origin and popup alignment point by setting the Placement property to Custom. Definire quindi un CustomPopupPlacementCallback delegato che restituisce un set di punti di posizionamento possibili e assi primari (in ordine di preferenza) Popupper.Then define a CustomPopupPlacementCallback delegate that returns a set of possible placement points and primary axes (in order of preference) for the Popup. Il punto che mostra la parte più grande di Popup è selezionato.The point that shows the largest portion of the Popup is selected. La posizione dell'oggetto Popup viene regolata automaticamente Popup se è nascosta al bordo dello schermo.The position of the Popup is automatically adjusted if the Popup is hidden by the edge of the screen. Per un esempio, vedere Procedura: Specificare una posizione personalizzata per un controllo Popup.For an example, see Specify a Custom Popup Position.

Vedere ancheSee also