TextPointer.GetCharacterRect(LogicalDirection) Metodo

Definizione

Restituisce un riquadro delimitatore del testo (Rect) per il contenuto che delimita l'oggetto TextPointer corrente nella direzione logica specificata.Returns a bounding box (Rect) for content that borders the current TextPointer in the specified logical direction.

public:
 System::Windows::Rect GetCharacterRect(System::Windows::Documents::LogicalDirection direction);
public System.Windows.Rect GetCharacterRect (System.Windows.Documents.LogicalDirection direction);
member this.GetCharacterRect : System.Windows.Documents.LogicalDirection -> System.Windows.Rect
Public Function GetCharacterRect (direction As LogicalDirection) As Rect

Parametri

direction
LogicalDirection

Uno dei valori LogicalDirection che specifica la direzione logica nella quale cercare un riquadro delimitatore del testo del contenuto.One of the LogicalDirection values that specifies the logical direction in which to find a content bounding box.

Restituisce

Un riquadro delimitatore del testo per il contenuto che delimita l'oggetto TextPointer corrente nella direzione specificata, oppure Empty se non sono disponibili informazioni valide correnti sul layout.A bounding box for content that borders the current TextPointer in the specified direction, or Empty if current, valid layout information is unavailable.

Implementazioni

System.Windows.Documents.ITextPointer.GetCharacterRect(System.Windows.Documents.LogicalDirection)

Commenti

TextElementi bordi non vengono considerati contenuti ai fini di questo metodo.TextElement edges are not considered content for the purposes of this method. Se l' TextPointer oggetto viene posizionato prima TextElement di un bordo, il valore restituito è un rettangoloTextElement di delimitazione per il successivo non contenuto nella direzione specificata.If the TextPointer is positioned before a TextElement edge, the return value is a bounding box for the next non-TextElement content in the specified direction. Se non è presente alcun contenuto nella direzione specificata, viene restituita una Rect larghezza di zero con un'altezza corrispondente all'altezza di qualsiasi contenuto precedente.If there is no content in the specified direction, a zero-width Rect is returned with a height matching the height of any preceding content.

L'operazione eseguita da questo metodo dipende da un layout valido.The operation performed by this method depends on a valid layout. Quando necessario, questo metodo tenta di rigenerare automaticamente un layout valido prima di procedere con l'operazione.When necessary, this method attempts to automatically regenerate a valid layout before proceeding with the operation. La rigenerazione di un layout può essere un'operazione relativamente dispendiosa.Regenerating a layout can be a relatively expensive operation. Utilizzare la HasValidLayout proprietà per verificare la presenza di un layout valido prima di eseguire operazioni che possono rigenerare il layout.Use the HasValidLayout property to check for a valid layout before performing operations that may regenerate the layout. Per altre informazioni, vedere Layout.For more information, see Layout.

Si applica a

Vedi anche