ITfRange-Schnittstelle (msctf.h)
Die ITfRange-Schnittstelle wird von Textdiensten und -anwendungen verwendet, um auf Text in einem bestimmten Kontext zu verweisen und zu bearbeiten. Die Schnittstellen-ID ist IID_ITfRange.
Vererbung
Die ITfRange-Schnittstelle erbt von der IUnknown-Schnittstelle . ITfRange verfügt auch über folgende Arten von Membern:
Methoden
Die ITfRange-Schnittstelle verfügt über diese Methoden.
| ITfRange::AdjustForInsert Die ITfRange::AdjustForInsert-Methode erweitert oder ordnet einen Textbereich an, der für das Einfügen von Text angepasst werden soll. |
| ITfRange::Clone Die ITfRange::Clone-Methode dupliziert diesen Textbereich. |
| ITfRange::Collapse Die ITfRange::Collapse-Methode löscht den Textbereich, indem der Start- und Endanker an die gleiche Position verschoben wird. |
| ITfRange::CompareEnd Die ITfRange::CompareEnd-Methode vergleicht die Endankerposition dieses Textbereichs mit einem Anker in einem anderen Bereich. |
| ITfRange::CompareStart Die ITfRange::CompareStart-Methode vergleicht die Startankerposition dieses Textbereichs mit einem Anker in einem anderen Bereich. |
| ITfRange::GetContext ITfRange::GetContext-Methode |
| ITfRange::GetEmbedded Die ITfRange::GetEmbedded-Methode ruft Inhalte ab, die einem TS_CHAR_EMBEDDED Zeichen im Textstream entsprechen. Der Startanker des Textbereichs befindet sich unmittelbar vor dem interessanten Zeichen. |
| ITfRange::GetFormattedText Die ITfRange::GetFormattedText-Methode ruft formatierten Inhalt ab, der in einem Textbereich enthalten ist. Der Inhalt wird in einem Objekt verpackt, das die IDataObject-Schnittstelle unterstützt. |
| ITfRange::GetGravity ITfRange::GetGravity-Methode |
| ITfRange::GetText Die ITfRange::GetText-Methode ruft den Inhalt ab, der von diesem Textbereich abgedeckt wird. |
| ITfRange::InsertEmbedded Die ITfRange::InsertEmbedded-Methode fügt ein Objekt an der Position des Startankers des Textbereichs ein. |
| ITfRange::IsEmpty Die ITfRange::IsEmpty-Methode überprüft, ob der Textbereich leer ist, da die Start- und Endanker die gleiche Position einnehmen. |
| ITfRange::IsEqualEnd Die ITfRange::IsEqualStart-Methode überprüft, ob der Endanker dieses Textbereichs mit einem Anker eines anderen angegebenen Bereichs übereinstimmt. |
| ITfRange::IsEqualStart Die ITfRange::IsEqualStart-Methode überprüft, ob der Startanker dieses Textbereichs einem Anker eines anderen angegebenen Bereichs entspricht. |
| ITfRange::SetGravity ITfRange::SetGravity-Methode |
| ITfRange::SetText Die ITfRange::SetText-Methode ersetzt den Inhalt, der durch den Textbereich abgedeckt wird. |
| ITfRange::ShiftEnd ITfRange::ShiftEnd-Methode |
| ITfRange::ShiftEndRegion ITfRange::ShiftEndRegion-Methode |
| ITfRange::ShiftEndToRange ITfRange::ShiftEndToRange-Methode |
| ITfRange::ShiftStart ITfRange::ShiftStart-Methode |
| ITfRange::ShiftStartRegion ITfRange::ShiftStartRegion-Methode |
| ITfRange::ShiftStartToRange ITfRange::ShiftStartToRange-Methode |
Hinweise
Diese Schnittstelle wird vom TSF-Manager implementiert. Weitere Informationen zu Bereichen, Ankern, eingebetteten Objekten und anderen Texteigenschaften, die von TSF verwendet werden, finden Sie unter Bereiche, eingebettete Objekte und andere Themen in Using Text Services Framework.
Beispiele
Sobald ein ITfComposition-Kompositionsobjekt instanziiert wurde, kann ein Zeiger auf einen ITfRange-Schnittstellenzeiger abgerufen werden, indem die ITfComposition::GetRange-Methode aufgerufen wird, wie im folgenden Codebeispiel gezeigt.
HRESULT hr;
ITfComposition *pComposition;
ITfRange *pRange;
WCHAR *achBuffer[64]; // Buffer to receive text.
ULONG cch;
hr = pComposition->GetRange(&pRange);
if(SUCCEEDED(hr))
{
// Loop to scan text:
do
{
cch = ARRAYSIZE(achBuffer);
hr = pRange->GetText(ec, TF_TF_MOVESTART | TF_TF_IGNOREEND, achBuffer, cch, &cch);
if(SUCCEEDED(hr))
{
// Do something with the text.
pRange->Release();
}
}
while (cch == ARRAYSIZE(achBuffer));
pComposition->Release();
}
Ein Zeiger auf ein aktuelles ITfRange-Objekt kann aus dem <range-Element> der TF_SELECTION-Struktur abgerufen werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | msctf.h |
| Verteilbare Komponente | TSF 1.0 unter Windows 2000 Professional |